informatiestandaarden - Gebruikersbijdragen [nl]

MedMij:V2018.05 OntwerpeAfspraak

2018-09-27T07:01:07Z

Marten Smits:

{{#customtitle:Use Cases eAfspraak}}

[[Bestand:EAfspraak_icoon_zonder_tekst.png |link=|links |87px|eAfspraak]]
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.05_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.05_FHIR_eAfspraak|Tecnical]]
desc none
</imagemap>

<div class="toclimit-{{{2|{{{limit|3}}}}}}">__TOC__</div>

=Inleiding=

==Algemeen==
Deze pagina beschrijft use cases waarbij een patiënt afspraken kan raadplegen, maken, annuleren of wijzigen met behulp van een persoonlijke gezondheidsomgeving. Algemene informatie betreffende deze use cases kan gevonden worden op deze [https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.05_Ontwerpen wiki pagina].

==Doelgroep==
De doelgroep voor deze pagina wijkt niet af van de algemene doelgroep van de MedMij functionele ontwerpen, die [[MedMij:V2018.05_Ontwerpen#Doelgroep| hier]] gevonden kan worden.

==Kaders en uitgangspunten==
===Richtlijn===
Geen nadere specificatie, anders dan genoemd in [[MedMij:V2018.05_Ontwerpen#Richtlijn| de algemene inleiding]] van de MedMij functionele ontwerpen.

===Infrastructuur===
Geen nadere specificatie, anders dan genoemd in [[MedMij:V2018.05_Ontwerpen#Infrastructuur| de algemene inleiding]] van de MedMij functionele ontwerpen.

===Geografische reikwijdte===
Geen nadere specificatie, anders dan genoemd in [[MedMij:V2018.05_Ontwerpen#Geografische_reikwijdte| de algemene inleiding]] van de MedMij functionele ontwerpen.

==Kwalificatie==
Op deze informatiestandaard is een Nictiz kwalificatie van toepassing.

=Use Cases=
Deze sectie vervolgt met de volgende use cases:
*[[#Use_case:_Afspraak_raadplegen_door_pati.C3.ABnt|Afspraak raadplegen]]
*[[#Use_case:_Afspraak_maken_door_pati.C3.ABnt|Afspraak maken]]
*[[#Use_case:_Afspraak_annuleren_door_pati.C3.ABnt|Afspraak annuleren]]
*[[#Use_case:_Afspraak_wijzigen_door_pati.C3.ABnt|Afspraak wijzigen]]
==Use case: Afspraak raadplegen door patiënt==
===Doel en relevantie===
Inzicht in afspraken biedt patiënten overzicht en gebruiksgemak. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van afspraken vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===

====Raadplegen afspraak ====
Het raadplegen van een afspraak gaat van een specifieke patiënt naar een specifieke organisatie in de zorg (bijvoorbeeld een zorgaanbieder).

Verdere informatie-elementen in de vraag om afspraken zijn:
*periode (startdatum - einddatum) waarin de afspraak plaats heeft gehad / heeft / zal hebben
Dit betreft dus de filtermogelijkheden (query parameters) in de vraag om afspraken.

====Beschikbaarstellen afspraak ====
De informatie-elementen voor beschikbaarstellen afspraak staan in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak]

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil afspraken raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt afspraken beschikbaar
|}
'''Bedrijfsrollen afspraak inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak raadplegen.png|Activiteitendiagram afspraak raadplegen]]

'''Activiteitendiagram afspraak raadplegen'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een aantal voor Thomas relevante situaties waarbij het raadplegen van afspraken een rol speelt.

<blockquote>Thomas heeft iedere drie maanden een controle in het ziekenhuis in verband met zijn Diabetes aandoening. De eerstkomende afspraak is op vrijdag 6 oktober 2017 om 10:30u met internist Janssen bij het Antonius Ziekenhuis in Rotterdam en duurt een uur. Het ziekenhuisinformatiesysteem heeft deze afspraak beschikbaar gemaakt voor de persoonlijke gezondheidsomgeving van Thomas. Thomas kan deze afspraak dan ook inzien via zijn persoonlijke gezondheidsomgeving.
----
Op 6 september belt de afdelingssecretaresse van het ziekenhuis. Zij heeft het verzoek aan Thomas of de afspraak verzet kan worden naar dinsdag 3 oktober om 16:00 uur. Dat komt hem prima uit, dus hij gaat akkoord. Het ziekenhuisinformatiesysteem maakt deze nieuwe afspraakinformatie beschikbaar voor de persoonlijke gezondheidsomgeving. Wanneer Thomas later die dag kijkt, ziet hij ook de bijgewerkte afspraakinformatie in zijn persoonlijke gezondheidsomgeving. Wel zo makkelijk, want hij was het eerder die dag vergeten op te schrijven.
</blockquote>

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het systeem van een zorgaanbieder (XIS) stelt de afspraak beschikbaar aan het systeem van een patiënt (PGO).
Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.
=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

De patiënt wil afspraken inzien en de zorgaanbieder stelt dit ook beschikbaar.
Een patiënt neemt steeds zelf het initiatief om zijn afspraken te raadplegen.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om afspraken in te zien.

=====Post conditie=====
De patiënt heeft afspraken geraadpleegd via de persoonlijke gezondheidsomgeving.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om afspraken van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| AfspraakRaadplegend
| style="background-color: white;"| EA-1.0.0-AFR-FHIR
| style="background-color: white;"| Raadplegen afspraak bij zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| AfspraakBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak aan de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak raadplegen (Totaal).png |Componenten diagram afspraak raadplegen]]

'''Componenten diagram afspraak raadplegen'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2018.05_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak raadplegen.png|Use case diagram afspraak raadplegen]]

'''Use case diagram afspraak raadplegen

==Use case: Afspraak maken door patiënt==
===Doel en relevantie===
Het maken van afspraken via een persoonlijke gezondheidsomgeving biedt patiënten gebruiksgemak. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het elektronisch en gestructureerd afspraken kunnen maken vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn vastgelegd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots

Sturen afspraakverzoek
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots

Ontvangen afspraak verzoek
|}
'''Bedrijfsrollen Afspraak inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak maken.png|Activiteitendiagram afspraak maken]]

'''Activiteitendiagram maken afspraak'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het maken van afspraken een rol speelt.

<blockquote>De persoonlijke gezondheidsomgeving van Thomas en het ziekenhuisinformatiesysteem (ZIS) van het Noorderziekenhuis in Groningen zijn verbonden vanwege een eerder bezoek van Thomas in het ziekenhuis.

Thomas wil een afspraak maken voor de driemaandelijkse controle met een diabetesverpleegkundige. Hij wil dit ergens in de tweede week van januari. Zijn persoonlijke gezondheidsomgeving haalt de beschikbare tijden voor deze afspraak op uit het Groningse ziekenhuisinformatiesysteem. Thomas kiest voor woensdag 10 januari van 14:00 – 15:00 uur. Dit verzoek gaat via zijn persoonlijke gezondheidsomgeving naar het ziekenhuisinformatiesysteem, dat de ontvangst van dit verzoek bevestigt. De afspraak is door Thomas te raadplegen via zijn persoonlijke gezondheidsomgeving.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Een persoonlijke gezondheidsomgeving kan voor een bepaalde periode én een bepaald type afspraak de beschikbare tijden ophalen uit het XIS. Dit betreft het raadplegen van beschikbare afspraak slots. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan - op basis van beschikbare slots - een verzoek tot het maken van een concrete afspraak doen aan het XIS. Een XIS kan een dergelijk afspraakverzoek wel/niet in behandeling nemen en stuurt daarvan een bevestiging.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch maken van afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil bepaalde typen afspraken maken en de zorgaanbieder ondersteunt het maken van deze afspraken.

=====Proces stappen=====
*Het systeem van de zorgaanbieder (XIS) levert de beschikbare afspraak slots op basis van de filter criteria uit de persoonlijke gezondheidsomgeving.
*Het systeem van de patiënt (PGO) stuurt een verzoek om een bepaald type afspraak te maken in een bepaalde slot.
*Het systeem van de zorgaanbieder (XIS) ontvangt het afspraakverzoek en geeft een technisch antwoord. Het antwoord geeft aan of het verzoek wel of niet in behandeling genomen kan worden.

Indien een verzoek in behandeling genomen kan worden door XIS, dan kan verwerking enige tijd vergen. Het verzoek wordt niet altijd direct afgehandeld.

Bij een eventueel negatief antwoord van het XIS kan een patiënt ervoor kiezen het opnieuw proberen, bijvoorbeeld met een ander (opnieuw opgevraagd) slot.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een afspraakverzoek.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| AfspraakSlotsRaadplegend
| style="background-color: white;"| EA-1.0.0-ASR-FHIR
| style="background-color: white;"| Raadplegen afspraak slots bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakverzoekSturend
| style="background-color: white;"| EA-1.0.0-AVS-FHIR
| style="background-color: white;"| Sturen afspraakverzoek naar zorgaanbieder
|-
| style="background-color: white;"| AfspraakSlotsBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ASB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak slots
|-
| style="background-color: white;"| AfspraakverzoekOntvangend
| style="background-color: white;"| EA-1.0.0-AVO-FHIR
| style="background-color: white;"| Ontvangen afspraakverzoek van de patient
|-
|}
Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak maken (Totaal).png|Componenten diagram afspraak maken]]

'''Componenten diagram afspraak maken'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakSlots (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="6"|[[MedMij:V2018.05_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakVerzoek (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraakverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AVS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraakverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AVO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak maken.png|Use case diagram afspraak maken]]

'''Use case diagram afspraak maken

==Use case: Afspraak annuleren door patiënt==
===Doel en relevantie===
Inzicht in afspraken biedt patiënten overzicht en gebruiksgemak. Dat is een functionaliteit die voorwaardelijk is voor deze use case: 'annuleren van afspraken'. Een patiënt is verder geholpen door ook afspraken te kunnen annuleren vanuit een persoonlijke gezondheidsomgeving. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het kunnen annuleren van een afspraak vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn gedefinieerd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
Sturen afspraak annulering
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
Ontvangen afspraak annulering
|}
'''Bedrijfsrollen afspraken inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak annuleren.png|Activiteitendiagram afspraak annuleren]]

'''Activiteitendiagram afspraak annuleren'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het annuleren van afspraken een rol speelt.

<blockquote>Thomas verhuist halverwege oktober 2017 voor zijn afstuderen naar Groningen. De afspraak voor de driemaandelijkse controle was al gemaakt in Rotterdam voor vrijdag 5 januari 2018. Thomas wil nu die afspraak afzeggen omdat hij die dag bezet is vanwege zijn afstudeerstage. Een nieuwe afspraak maakt hij liever in Groningen, dat is voor hem nu veel handiger.
Hij gebruikt zijn PGO om een verzoek te doen de afspraak in Rotterdam te annuleren. Een aantal uren later bevestigt de medisch secretaresse deze annulering. Thomas kan de afspraken weer raadplegen via zijn PGO.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Een persoonlijke gezondheidsomgeving kan achterhalen welk afspraken het verbonden XIS heeft voor de patiënt. Dit betreft het raadplegen van afspraken. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan voor een bestaande afspraak een verzoek doen tot annulering. Een XIS ontvangt, behandelt en beantwoordt een dergelijk verzoek.

Een PGO heeft afspraken geraadpleegd en opvolging verzoek beoordeeld. Mocht het verzoek niet verwerkt zijn, kan een patiënt ervoor kiezen het opnieuw te proberen, of op een andere manier de zorgaanbieder te benaderen. Indien het verzoek verwerkt is, stelt XIS bij raadpleging door PGO de afspraak met status ‘geannuleerd’ beschikbaar.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van informatie over afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil bepaalde afspraken kunnen annuleren en de zorgaanbieder ondersteunt dit.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) raadpleegt de beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Het systeem van de patiënt (PGO) stuurt een verzoek om de bestaande afspraak te annuleren.
*Het systeem van de zorgaanbieder (XIS) ontvangt de annulering en geeft een technisch antwoord. Het antwoord kan positief of negatief zijn voor het doorvoeren van de annulering.
*Het systeem van de patiënt (PGO) raadpleegt de beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken (waaronder de geannuleerde afspraak met status 'geannuleerd') op voor de patiënt.

Indien het verzoek verwerkt kan worden, stelt XIS de afspraak met status 'geannuleerd' beschikbaar, na raadpleging door patiënt vanuit zijn PGO.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een verzoek tot annulering van een afspraak.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="2"| PGO
| style="background-color: white;"| AfsprakenRaadplegend
| style="background-color: white;"| EA-1.0.0-AFR-FHIR
| style="background-color: white;"| Raadplegen afspraken bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakAnnuleringSturend
| style="background-color: white;"| EA-1.0.0-AAS-FHIR
| style="background-color: white;"| Sturen afspraak annulering naar de zorgaanbieder
|-
| style="background-color: white;" rowspan="2"| XIS
| style="background-color: white;"| AfsprakenBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraken aan de patiënt
|-
| style="background-color: white;"| AfspraakAnnuleringOntvangend
| style="background-color: white;"| EA-1.0.0-AAO-FHIR
| style="background-color: white;"| Ontvangen afspraak annulering van de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak annuleren (Totaal).png |Componenten diagram afspraak annuleren]]

'''Componenten diagram afspraak annuleren'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="4"|[[MedMij:V2018.05_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakAnnulering (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraak annulering
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AAS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraak annulering
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AAO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak annuleren.png |Use case diagram afspraak annuleren]]

'''Use case diagram afspraak annuleren

==Use case: Afspraak wijzigen door patiënt==
===Doel en relevantie===
Inzicht in en het maken van afspraken biedt patiënten overzicht en gebruiksgemak. Dat zijn functionaliteiten die voorwaardelijk zijn voor deze use case: 'wijzigen van afspraken'. Een patiënt is verder geholpen door ook afspraken te kunnen wijzigen vanuit een persoonlijke gezondheidsomgeving. Een wijziging kan ook een annulering betreffen. Dit draagt verder bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het kunnen wijzigen van een afspraak vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn gedefinieerd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak

Raadplegen afspraak slots

Sturen afspraak wijzigingsverzoek
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak

Beschikbaarstellen afspraak slots

Ontvangen afspraak wijzigingsverzoek
|}
'''Bedrijfsrollen afspraken inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak wijzigen.png|Activiteitendiagram afspraak wijzigen]]

'''Activiteitendiagram afspraak wijzigen'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het wijzigen van afspraken een rol speelt.

<blockquote>In de loop van december krijgt Thomas een buitenkansje. Een aantal van zijn vrienden gaan met skivakantie van zaterdag 5 t/m 12 januari en er is een plekje vrijgekomen. Voor een zacht prijsje kan hij mee. Daar heeft hij veel zin in!

Thomas zet de skivakantie ‘s avonds laat in zijn agenda en ziet dat dit conflicteert met zijn controle-afspraak in het Noorderziekenhuis op 10 januari. Hij moet die afspraak gaan verzetten. Het is 23:15 en dus te laat om het ziekenhuis hiervoor direct te bellen.

Via zijn PGO kijkt hij daarom naar beschikbare tijden in de derde week van januari. Er blijkt gelukkig nog een gaatje te zijn op vrijdag 19 januari om 11:30 – 12:30. Het verzoek om te wijzigen gaat via zijn PGO naar het ZIS, dat de ontvangst van het verzoek bevestigt. Bij raadpleging van de afspraken vanuit PGO, stelt XIS de nieuwe afspraak beschikbaar, alsmede de oorspronkelijke afspraak met status ‘ geannuleerd’.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Het systeem van een zorgaanbieder (XIS) stelt afspraken beschikbaar aan het systeem van een patiënt (PGO).
*Een persoonlijke gezondheidsomgeving kan voor een bepaalde periode én een bepaald type afspraak de beschikbare tijden ophalen uit het XIS. Dit betreft het raadplegen van beschikbare afspraak slots. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan - op basis van beschikbare slots - een verzoek tot het wijzigen van een concrete afspraak doen aan het XIS. Een XIS kan een dergelijk afspraak wijzigingsverzoek behandelen en ontvangst van het verzoek bevestigen.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van informatie over afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil een afspraak wijzigen en de zorgaanbieder ondersteunt het wijzigen van afspraken.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om afspraken in te zien en er één te selecteren die hij wil wijzigen.
*Het systeem van de patiënt (PGO) vraagt om beschikbare slots voor een bepaald type afspraak in een bepaalde tijdsperiode bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de beschikbare afspraak slots op basis van de filter criteria uit de persoonlijke gezondheidsomgeving.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om beschikbare slots in te zien en er één te selecteren.
*Het systeem van de patiënt (PGO) stuurt een verzoek om de bestaande afspraak te wijzigen.
*Het systeem van de zorgaanbieder (XIS) ontvangt het afspraak wijzigingsverzoek en geeft een technisch antwoord. Het antwoord kan positief of negatief zijn voor de wijziging.

Patiënt raadpleegt opnieuw de afspraken vanuit zijn PGO + XIS stelt de nieuwe afspraak beschikbaar, alsmede de oorspronkelijke afspraak met status ‘geannuleerd’.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een afspraak wijzigingsverzoek.

Bij een eventueel negatief antwoord van het XIS kan een patiënt ervoor kiezen het opnieuw proberen, bijvoorbeeld met een ander (opnieuw opgevraagd) slot.
Bij een positief antwoord is de afspraak gewijzigd en inzichtelijk in zowel XIS als PGO.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="4"| PGO
| style="background-color: white;"| AfspraakRaadplegend
| style="background-color: white;"| EA-1.0.0-AFO-FHIR
| style="background-color: white;"| Raadplegen afspraak bij zorgaanbieder
|-
| style="background-color: white;"| AfspraakSlotsRaadplegend
| style="background-color: white;"| EA-1.0.0-ASR-FHIR
| style="background-color: white;"| Raadplegen afspraak slots bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakWijzigingsverzoekSturend
| style="background-color: white;"| EA-1.0.0-AWS-FHIR
| style="background-color: white;"| Sturen afspraak wijzigingsverzoek
|-
| style="background-color: white;" rowspan="4"| XIS
| style="background-color: white;"| AfspraakBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak aan de patiënt
|-
| style="background-color: white;"| AfspraakSlotsBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ASB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak slots
|-
| style="background-color: white;"| AfspraakWijzigingsverzoekOntvangend
| style="background-color: white;"| EA-1.0.0-AWO-FHIR
| style="background-color: white;"| Ontvangen afspraak wijzigingsverzoek van de patiënt.
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak wijzigen (Totaal).png|Componenten diagram afspraak wijzigen]]

'''Componenten diagram afspraak wijzigen'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="8"|[[MedMij:V2018.05_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakSlots (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakWijziging (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraak wijzigingsverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AWS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraak wijzigingsverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AWO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak wijzigen.png|Use case diagram afspraak wijzigen]]

'''Use case diagram afspraak wijzigen

=Functionaliteit=
-

=Verantwoordelijkheid voor informatie=
Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

=Infrastructuur=
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| AUTEUR(S)
| style="background-color: white;"| TITEL
| style="background-color: white;"| VERSIE
| style="background-color: white;"| DATUM
| style="background-color: white;"| BRON
| style="background-color: white;"| ORGANISATIE
|}
'''Referenties

MedMij:V2018.05 FHIR IG

2018-09-26T11:42:49Z

Marten Smits:

{{#customtitle:MedMij FHIR Implementation Guide}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 03 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.05_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.05_FHIR_IG|Technisch]]
desc none
</imagemap>
__TOC__

{{large|Quick links}}
----
{|
! [[Bestand:BGZ_icoon.png |link=MedMij:V2018.05_FHIR_BGZ_2017 |100px|Patient Summary (BgZ)]]
!   
! [[Bestand:Medication_Icoon.png |link=MedMij:V2018.05_FHIR_MedicationProcess|100px |Medication Process]]
!   
! [[Bestand:AllergyIntolerance.png |link=MedMij:V2018.05_FHIR_AllergyIntolerance|106px |Allergy Intolerance]]
!   
! [[Bestand:Self-measurements_Icoon.png |link=MedMij:V2018.05_FHIR_VitalSigns|105px |Self-Measurements]]
!   
! [[Bestand:LabResults@2x.png |link=MedMij:V2018.05_FHIR_LaboratoryResults |100px|Laboratory Results]]
!   
! [[Bestand:PDF-A icoon.png|link=MedMij:V2018.05_FHIR_PDFA |100px |PDF/A - Health Documents]]
!   
! [[Bestand:EAfspraak_-_text.png |link=MedMij:V2018.05_FHIR_eAfspraak |98px |eAfspraak - Appointments]]
!   
! [[Bestand:Huisartsgegevens-met-tekst.png|link=MedMij:V2018.05_FHIR_GP_Data |105px |Huisartsgegevens - GP Data]]
!   
! [[Bestand:MedMij-GGZ-63.png|link=MedMij:V2018.05_FHIR_GGZ |105px |GGZ]]
|}

=About the IG=
This is the technical MedMij FHIR implementation guide based on '''HL7® FHIR® version STU3'''.

==Purpose==
An implementation guide for making use of FHIR in the Dutch context. This guide is developed specifically for the use of HL7® FHIR® between personal health records(PHR) and healthcare provider systems (XIS). PHR and XIS vendors that participate in MedMij conform to a framework of agreements, in Dutch this is called the 'afsprakenstelsel.' HL7 FHIR, or just 'FHIR', plays an important role among those agreements and is used as a standard to exchange health information between the involved parties. The purpose of this guide is to describe use cases and provide technical guidance on how to implement FHIR in these situations. This guide outlines the FHIR building blocks, or profiles, involved in these use cases. Moreover, this guide provides a textual explanation of these building blocks and describes their relationship and boundaries.

==Scope==
The scope of this guide includes requirements to enable PHR and XIS in the Dutch realm to use standardized structured data in a defined inter-organizational transaction. Health is a vast domain. Therefore, MedMij has made scoping choices for its roadmap. MedMij starts with a limited number of medical subdomains but has the vision to elaborate on more domains later. In scope domains are first described in the [[MedMij:V2018.05_Ontwerpen|functional design]] that underlies this technical design.

==Background==
MedMij aims to stimulate electronic information exchange between patients and caregivers. Caregivers generally have access to software applications to help them support their work in treating patients. Software applications for patients are evolving as we speak, but patients typically are not yet enabled to be regarded as a true partner in the care process. MedMij delivers an agreements scheme to enable patients to become that true partner. The section [[#Afsprakenstelsel]] describes the relation to this implementation guide.

Information standards have a functional and technical component. The functional part contains definitions of relevant concepts (dataset) and scenario’s that define when to exchange which of those concepts. The technical part translates the functional scenario’s in an exchange format (such as HL7v3 or FHIR). The stakeholders in MedMij have chosen to introduce FHIR as a modern standard to exchange information in MedMij. A dutch factsheet that explains why FHIR is chosen is available on the [https://www.medmij.nl/wp-content/uploads/2017/06/Factsheet-MedMij-FHIR.pdf MedMij website]. MedMij delivers a FHIR representation ([http://hl7.org/fhir/STU3/profiling.html profiles]) for each domain in scope.

The program ‘Registratie aan de bron’ (Data capture at the point of Care) has defined [https://zibs.nl/wiki/HCIM_Mainpage| Health and Care Information models] (zorginformatiebouwstenen or ZIB's) for The Netherlands. ZIB's contain definitions of healthcare concepts. MedMij information standards contain mappings to these ZIB's. MedMij creates FHIR profiles based on ZIB's which include mappings to the relevant ZIB concepts. As a result, the created profiles enable context-free implementation. Therefore, these profiles are applicable in a broader context than the described use cases or the MedMij context. Reuse of these profiles enables interoperability for health information.

==Audience==
The main target audience of this implementation guide is software vendors and developers that will implement FHIR as part of electronic information exchange under MedMij. This IG is intended for developers of PHR as well as XIS vendors.
Users of this guide are expected to be familiar with the [http://hl7.org/fhir/stu3 FHIR specification] and resource processing. This guide provides links to relevant sections of the FHIR specification. This implementation guide is not intended to be a tutorial on that subject.

==Language==
This implementation guide is written in English, even though the majority of the documentation in MedMij is in Dutch. A Dutch translation of this document may become available. However, the English version is and remains leading. The rationale for choosing English is as follows. Implementers in healthcare are in many cases foreign, e.g., through outsourcing or because the company is a multinational. But even if they are Dutch native speakers, the educational tracks, their programming language of choice, and the implementer communities they are part of will largely be based on the English language. In creating the documentation for the target audience, we have received overwhelming preference from the MedMij implementer community for English. English documentation saves them investments and risks in getting a translation agency on a per vendor basis for each version of the documentation, while at the same time not alienating the native Dutch speaking audience. As a side effect it also helps Nictiz in the international realm in discussions with relevant initiatives such as Argonaut (US), Patients Know Best (UK), the Finnish PHR, and the HL7/FHIR community at large.

=Afsprakenstelsel=
[[Bestand:Afsprakenstelsel-01.png|link=https://www.medmij.nl/afsprakenstelsel/|rechts |100px|Go to Afsprakenstelsel]]
The 'afsprakenstelsel' references the MedMij information standards. In addition, the MedMij information standards are specified in the context of the 'afsprakenstelsel.' This applies to the implementation guidance of the use cases described in this implementation guide.

For example, all use cases performed in the context of a specific authenticated patient, for which an OAuth2 token has been retrieved using the Authentication mechanisms described in the [https://www.medmij.nl/afsprakenstelsel/ 'afsprakenstelsel']. This token must be passed in each call in the HTTP header named “Authorization”. Each XIS Gateway is required to perform filtering based on the patient associated with the OAuth2 token received for the request so that only the records associated with the authenticated patient are returned.

=Functional design=
[[Bestand:Functioneel-02.png|link=MedMij:V2018.05_Ontwerpen |100px|rechts|Functional design|Go to functional design]]

All use cases described in this implementation guide have a functional counterpart. The functional design pages are written in Dutch. The main overarching wiki page of the functional designs can be found at [[MedMij:V2018.05_Ontwerpen|here]]. From this page, you can link to the specific use case through the patient journey image or the table index. It is possible to link to the specific functional design page from the technical use case pages in this wiki by clicking on the functional circle in the top image.

=Use cases=
Implementation guidance is provided per use case on separate wiki pages. The next section provides implemenation guidance that apply for all use cases. The green circles represent the available use cases. Click on the circle to go to the use case page.

{|
! [[Bestand:BGZ_icoon.png |link=MedMij:V2018.05_FHIR_BGZ_2017 |100px|Patient Summary (BgZ)]]
!   
! [[Bestand:Medication_Icoon.png |link=MedMij:V2018.05_FHIR_MedicationProcess|100px |Medication Process]]
!   
! [[Bestand:AllergyIntolerance.png |link=MedMij:V2018.05_FHIR_AllergyIntolerance|106px |Allergy Intolerance]]
!   
! [[Bestand:Self-measurements_Icoon.png |link=MedMij:V2018.05_FHIR_VitalSigns|105px |Self-Measurements]]
!   
! [[Bestand:LabResults@2x.png |link=MedMij:V2018.05_FHIR_LaboratoryResults |100px|Laboratory Results]]
!   
! [[Bestand:PDF-A icoon.png|link=MedMij:V2018.05_FHIR_PDFA |100px |PDF/A - Health Documents]]
!   
! [[Bestand:EAfspraak_-_text.png |link=MedMij:V2018.05_FHIR_eAfspraak |98px |eAfspraak - Appointments]]
!   
! [[Bestand:Huisartsgegevens-met-tekst.png|link=MedMij:V2018.05_FHIR_GP_Data |105px |Huisartsgegevens - GP Data]]
!   
! [[Bestand:MedMij-GGZ-63.png|link=MedMij:V2018.05_FHIR_GGZ |105px |GGZ]]
|}

=Use case overarching principles=
==Content Types and encodings==
MedMij uses the [http://hl7.org/fhir/http.html#mime-type FHIR RESTful framework]. This framework defines at least three content-types to send/retrieve information. Clients may ask servers specifically for information in a given content-type. Servers SHALL support server-driven content negotiation as described in [http://www.w3.org/Protocols/rfc2616/rfc2616-sec12.html#sec12 section 12] of the HTTP specification.

* XML: application/fhir+xml
* JSON: application/fhir+json
* RDF: text/turtle - Not supported in MedMij

Servers in MedMij SHALL support both XML and JSON. Clients MAY negotiate using the HTTP standard which they prefer. If a client does not request a specific content-type, then it is server discretion if they respond using XML or JSON content-type.

FHIR uses UTF-8 for all request and response bodies. Since the HTTP specification (section 3.7.1) defines a default character encoding of ISO-8859-1, requests and responses SHALL explicitly set the character encoding to UTF-8 using the charset parameter of the MIME-type in the Content-Type header. Requests MAY also specify this charset parameter in the Accept header and/or use the Accept-Charset header.

==Retrieve information: what's new==
Retrieving information that was added, changed, deleted relative to a date may be done using the search parameter <code>_lastUpdated</code> available for any resource. Using the parameter <code>_lastUpdated</code> a system may query for data that is ''new'' since the previous query. Any FHIR server is expected to support this parameter <code>_lastUpdated</code>.

The search parameter _lastUpdated can be used to select resources based on the last time they were changed:

GET [base]/Observation?_lastUpdated=gt2018-10-01

This search finds any observations changed since Oct 1, 2018. More information may be found in the section _lastUpdated in the FHIR specification: http://hl7.org/fhir/STU3/search.html#lastUpdated.

An example search request is shown below.

<pre>GET [base]/Consent?category=http://snomed.info/sct|11291000146105&_lastUpdated=gt2018-10-01</pre>

This search finds all Consent resources with a category SNOMED code 11291000146105 that have been changed since Oct 1, 2018.

=Relevant links=
'''HL7 FHIR specification'''
* [http://hl7.org/fhir/STU3/index.html HL7 FHIR STU3]
* [http://wiki.hl7.org/index.php?title=FHIR FHIR wiki]

'''Repository of MedMij FHIR artefacts'''
* [https://simplifier.net/NictizSTU3-Zib2017 Simplifier.net]
** [https://github.com/Nictiz/Nictiz-STU3-Zib2017 GitHub] (similar as Simplifier.net)

'''Test Tools'''
* MedMij FHIR server - https://vonk.test-nictiz.nl
* Windows desktop validator using .NET HL7 FHIR Profile Validation API - [https://github.com/ewoutkramer/Furore.Fhir.ValidationDemo link to download]

=Contact=

'''MedMij'''

W: http://www.medmij.nl

E: standaarden@medmij.nl

'''Nictiz'''

W: https://www.nictiz.nl

T: [tel:+31703173450 +31-70 317 3450]

'''Feedback on content in open consultation'''
* [https://www.medmij.nl/consultatiedocumenten/ Documentation]
* [https://bits.nictiz.nl/secure/BrowseProjects.jspa#all BITS for issues]

'''FHIR Questions and Discussions'''

* [http://chat.fhir.org chat.fhir.org]

=Release Notes=

{| class="wikitable"
! Version !! Date !! Notes
|-
| [[MedMij:V2018.05_FHIR_IG|2018.05]] || 2018-09-24 || Added GGZ for open consultation
|-
| [[MedMij:V2018.04_FHIR_IG|2018.04]] || 2018-08-29 || eAfspraak fase 2
|-
| [[MedMij:V2018.03_FHIR_IG|2018.03]] || 2018-05-07 || Published BgZ 2017 and GP Data
|-
| [[MedMij:V2018.02_FHIR_IG|2018.02]] || 2018-03-29 || Added BgZ 2017
|-
| [[MedMij:V2018.01_FHIR_IG|2018.01]] || 2018-02-21 || Added GP patient data
|-
| [[MedMij:V2017.04_FHIR_IG|2017.04]] || 2017-12-18 || Added Appointments, Medication, Laboratory results, AllergyIntolerance, Self-measurements
|-
| [[MedMij:V2017.03_FHIR_IG|2017.03]] || 2017-11-07 || Added PDF/A
|-
| [[MedMij:V2017.02_Ontwerpen|2017.02]] || 2017-10-11 || Unchanged. No wiki pages created for FHIR
|-
| [[MedMij:V2017.01_FHIR_IG|2017.01]] || 2017-10-02 || Initial version containing Patient Administration Resources, Patient Summary (BgZ),
|}

MedMij:V2018.04 FHIR IG

2018-08-30T14:08:11Z

Marten Smits:

{{#customtitle:MedMij FHIR Implementation Guide}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 03 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.04_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.04_FHIR_IG|Technisch]]
desc none
</imagemap>
__TOC__

{{large|Quick links}}
----
{|
! [[Bestand:BGZ_icoon.png |link=MedMij:V2018.04_FHIR_BGZ_2017 |100px|Patient Summary (BgZ)]]
!   
! [[Bestand:Medication_Icoon.png |link=MedMij:V2018.04_FHIR_MedicationProcess|100px |Medication Process]]
!   
! [[Bestand:AllergyIntolerance.png |link=MedMij:V2018.04_FHIR_AllergyIntolerance|106px |Allergy Intolerance]]
!   
! [[Bestand:Self-measurements_Icoon.png |link=MedMij:V2018.04_FHIR_VitalSigns|105px |Self-Measurements]]
!   
! [[Bestand:LabResults@2x.png |link=MedMij:V2018.04_FHIR_LaboratoryResults |100px|Laboratory Results]]
!   
! [[Bestand:PDF-A icoon.png|link=MedMij:V2018.04_FHIR_PDFA |100px |PDF/A - Health Documents]]
!   
! [[Bestand:EAfspraak_-_text.png |link=MedMij:V2018.04_FHIR_eAfspraak |98px |eAfspraak - Appointments]]
!   
! [[Bestand:Huisartsgegevens-met-tekst.png|link=MedMij:V2018.04_FHIR_GP_Data |105px |Huisartsgegevens - GP Data]]
|}

=About the IG=
This is the technical MedMij FHIR implementation guide based on '''HL7® FHIR® version STU3'''.

==Purpose==
An implementation guide for making use of FHIR in the Dutch context. This guide is developed specifically for the use of HL7® FHIR® between personal health records(PHR) and healthcare provider systems (XIS). PHR and XIS vendors that participate in MedMij conform to a framework of agreements, in Dutch this is called the 'afsprakenstelsel.' HL7 FHIR, or just 'FHIR', plays an important role among those agreements and is used as a standard to exchange health information between the involved parties. The purpose of this guide is to describe use cases and provide technical guidance on how to implement FHIR in these situations. This guide outlines the FHIR building blocks, or profiles, involved in these use cases. Moreover, this guide provides a textual explanation of these building blocks and describes their relationship and boundaries.

==Scope==
The scope of this guide includes requirements to enable PHR and XIS in the Dutch realm to use standardized structured data in a defined inter-organizational transaction. Health is a vast domain. Therefore, MedMij has made scoping choices for its roadmap. MedMij starts with a limited number of medical subdomains but has the vision to elaborate on more domains later. In scope domains are first described in the [[MedMij:V2018.04_Ontwerpen|functional design]] that underlies this technical design.

==Background==
MedMij aims to stimulate electronic information exchange between patients and caregivers. Caregivers generally have access to software applications to help them support their work in treating patients. Software applications for patients are evolving as we speak, but patients typically are not yet enabled to be regarded as a true partner in the care process. MedMij delivers an agreements scheme to enable patients to become that true partner. The section [[#Afsprakenstelsel]] describes the relation to this implementation guide.

Information standards have a functional and technical component. The functional part contains definitions of relevant concepts (dataset) and scenario’s that define when to exchange which of those concepts. The technical part translates the functional scenario’s in an exchange format (such as HL7v3 or FHIR). The stakeholders in MedMij have chosen to introduce FHIR as a modern standard to exchange information in MedMij. A dutch factsheet that explains why FHIR is chosen is available on the [https://www.medmij.nl/wp-content/uploads/2017/06/Factsheet-MedMij-FHIR.pdf MedMij website]. MedMij delivers a FHIR representation ([http://hl7.org/fhir/STU3/profiling.html profiles]) for each domain in scope.

The program ‘Registratie aan de bron’ (Data capture at the point of Care) has defined [https://zibs.nl/wiki/HCIM_Mainpage| Health and Care Information models] (zorginformatiebouwstenen or ZIB's) for The Netherlands. ZIB's contain definitions of healthcare concepts. MedMij information standards contain mappings to these ZIB's. MedMij creates FHIR profiles based on ZIB's which include mappings to the relevant ZIB concepts. As a result, the created profiles enable context-free implementation. Therefore, these profiles are applicable in a broader context than the described use cases or the MedMij context. Reuse of these profiles enables interoperability for health information.

==Audience==
The main target audience of this implementation guide is software vendors and developers that will implement FHIR as part of electronic information exchange under MedMij. This IG is intended for developers of PHR as well as XIS vendors.
Users of this guide are expected to be familiar with the [http://hl7.org/fhir/stu3 FHIR specification] and resource processing. This guide provides links to relevant sections of the FHIR specification. This implementation guide is not intended to be a tutorial on that subject.

==Language==
This implementation guide is written in English, even though the majority of the documentation in MedMij is in Dutch. A Dutch translation of this document may become available. However, the English version is and remains leading. The rationale for choosing English is as follows. Implementers in healthcare are in many cases foreign, e.g., through outsourcing or because the company is a multinational. But even if they are Dutch native speakers, the educational tracks, their programming language of choice, and the implementer communities they are part of will largely be based on the English language. In creating the documentation for the target audience, we have received overwhelming preference from the MedMij implementer community for English. English documentation saves them investments and risks in getting a translation agency on a per vendor basis for each version of the documentation, while at the same time not alienating the native Dutch speaking audience. As a side effect it also helps Nictiz in the international realm in discussions with relevant initiatives such as Argonaut (US), Patients Know Best (UK), the Finnish PHR, and the HL7/FHIR community at large.

=Afsprakenstelsel=
[[Bestand:Afsprakenstelsel-01.png|link=https://www.medmij.nl/afsprakenstelsel/|rechts |100px|Go to Afsprakenstelsel]]
The 'afsprakenstelsel' references the MedMij information standards. In addition, the MedMij information standards are specified in the context of the 'afsprakenstelsel.' This applies to the implementation guidance of the use cases described in this implementation guide.

For example, all use cases performed in the context of a specific authenticated patient, for which an OAuth2 token has been retrieved using the Authentication mechanisms described in the [https://www.medmij.nl/afsprakenstelsel/ 'afsprakenstelsel']. This token must be passed in each call in the HTTP header named “Authorization”. Each XIS Gateway is required to perform filtering based on the patient associated with the OAuth2 token received for the request so that only the records associated with the authenticated patient are returned.

=Functional design=
[[Bestand:Functioneel-02.png|link=MedMij:V2018.04_Ontwerpen |100px|rechts|Functional design|Go to functional design]]

All use cases described in this implementation guide have a functional counterpart. The functional design pages are written in Dutch. The main overarching wiki page of the functional designs can be found at [[MedMij:V2018.04_Ontwerpen|here]]. From this page, you can link to the specific use case through the patient journey image or the table index. It is possible to link to the specific functional design page from the technical use case pages in this wiki by clicking on the functional circle in the top image.

=Use cases=
Implementation guidance is provided per use case on separate wiki pages. The next section provides implemenation guidance that apply for all use cases. The green circles represent the available use cases. Click on the circle to go to the use case page.

{|
! [[Bestand:BGZ_icoon.png |link=MedMij:V2018.04_FHIR_BGZ_2017 |100px|Patient Summary (BgZ)]]
!   
! [[Bestand:Medication_Icoon.png |link=MedMij:V2018.04_FHIR_MedicationProcess|100px |Medication Process]]
!   
! [[Bestand:AllergyIntolerance.png |link=MedMij:V2018.04_FHIR_AllergyIntolerance|106px |Allergy Intolerance]]
!   
! [[Bestand:Self-measurements_Icoon.png |link=MedMij:V2018.04_FHIR_VitalSigns|105px |Self-Measurements]]
!   
! [[Bestand:LabResults@2x.png |link=MedMij:V2018.04_FHIR_LaboratoryResults |100px|Laboratory Results]]
!   
! [[Bestand:PDF-A icoon.png|link=MedMij:V2018.04_FHIR_PDFA |100px |PDF/A - Health Documents]]
!   
! [[Bestand:EAfspraak_-_text.png |link=MedMij:V2018.04_FHIR_eAfspraak |98px |eAfspraak - Appointments]]
!   
! [[Bestand:Huisartsgegevens-met-tekst.png|link=MedMij:V2018.04_FHIR_GP_Data |105px |Huisartsgegevens - GP Data]]
|}

=Use case overarching principles=
==Retrieve information: what's new==
Retrieving information that was added, changed, deleted relative to a date may be done using the search parameter <code>_lastUpdated</code> available for any resource. Using the parameter <code>_lastUpdated</code> a system may query for data that is ''new'' since the previous query. Any FHIR server is expected to support this parameter <code>_lastUpdated</code>.

The search parameter _lastUpdated can be used to select resources based on the last time they were changed:

GET [base]/Observation?_lastUpdated=gt2018-10-01

This search finds any observations changed since Oct 1, 2018. More information may be found in the section _lastUpdated in the FHIR specification: http://hl7.org/fhir/STU3/search.html#lastUpdated.

An example search request is shown below.

<pre>GET [base]/Consent?category=http://snomed.info/sct|11291000146105&_lastUpdated=gt2018-10-01</pre>

This search finds all Consent resources with a category SNOMED code 11291000146105 that have been changed since Oct 1, 2018.

=Relevant links=
'''HL7 FHIR specification'''
* [http://hl7.org/fhir/STU3/index.html HL7 FHIR STU3]
* [http://wiki.hl7.org/index.php?title=FHIR FHIR wiki]

'''Repository of MedMij FHIR artefacts'''
* [https://simplifier.net/NictizSTU3-Zib2017 Simplifier.net]
** [https://github.com/Nictiz/Nictiz-STU3-Zib2017 GitHub] (similar as Simplifier.net)

'''Test Tools'''
* MedMij FHIR server - https://vonk.test-nictiz.nl
* Windows desktop validator using .NET HL7 FHIR Profile Validation API - [https://github.com/ewoutkramer/Furore.Fhir.ValidationDemo link to download]

=Contact=

'''MedMij'''

W: http://www.medmij.nl

E: standaarden@medmij.nl

'''Nictiz'''

W: https://www.nictiz.nl

T: [tel:+31703173450 +31-70 317 3450]

'''Feedback on content in open consultation'''
* [https://www.medmij.nl/consultatiedocumenten/ Documentation]
* [https://bits.nictiz.nl/secure/BrowseProjects.jspa#all BITS for issues]

'''FHIR Questions and Discussions'''

* [http://chat.fhir.org chat.fhir.org]

=Release Notes=

{| class="wikitable"
! Version !! Date !! Notes
|-
| [[MedMij:V2018.03_FHIR_IG|2018.02]] || 2018-08-30 || eAfspraak fase 2
|-
| [[MedMij:V2018.03_FHIR_IG|2018.02]] || 2018-05-07 || Published BgZ 2017 and GP Data
|-
| [[MedMij:V2018.02_FHIR_IG|2018.02]] || 2018-03-29 || Added BgZ 2017 for public consultation
|-
| [[MedMij:V2018.01_FHIR_IG|2018.01]] || 2018-02-21 || Added GP patient data
|-
| [[MedMij:V2017.04_FHIR_IG|2017.04]] || 2017-12-18 || Added Appointments, Medication, Laboratory results, AllergyIntolerance, Self-measurements
|-
| [[MedMij:V2017.03_FHIR_IG|2017.03]] || 2017-11-07 || Added PDF/A.
|-
| [[MedMij:V2017.02_Ontwerpen|2017.02]] || 2017-10-11 || Unchanged. No wiki pages created for FHIR.
|-
| [[MedMij:V2017.01_FHIR_IG|2017.01]] || 2017-10-02 || Initial version containing Patient Administration Resources, Patient Summary (BgZ),
|}

MedMij:V2018.04 Ontwerpen

2018-08-30T14:07:36Z

Marten Smits:

{{#customtitle:Ontwerpen MedMij|Functioneel Ontwerpen}}
{{IssueBox|Dit is een werkpagina.

De gepubliceerde versie kan hier gevonden worden: https://informatiestandaarden.nictiz.nl/wiki/MedMij:Vcurrent_Ontwerpen}}
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.04_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.04_FHIR_IG|Technisch]]
desc none
</imagemap>

=Inleiding=
==Algemeen==
Hier vindt u informatie over de ''inhoud'' van de informatie die kan worden uitgewisseld in het [https://www.medmij.nl/afsprakenstelsel/ MedMij afsprakenstelstel].

Deze pagina beschrijft allereerst de algemeen geldende en overkoepelende informatie van de functionele ontwerpen voor MedMij en bevat vervolgens [[#Ontwerpen|verwijzingen]] naar specifieke functionele ontwerpen en technische specificaties voor die use cases die onderdeel zijn van het afsprakenstelsel.

==Doelgroep==
De doelgroep voor deze pagina bestaat uit:
* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz;
* Vertegenwoordigers van patiënten, laboratoria en zorgverleners.

==Kaders en uitgangspunten==

===Richtlijn===
Het programma '[https://www.registratieaandebron.nl Registratie aan de bron]' heeft zorginformatiebouwstenen voor Nederland gedefinieerd. Een zorginformatiebouwsteen (ZIB) beschrijft nauwkeurig wat er over een bepaald onderwerp van het zorgproces van de patiënt moet worden vastgelegd. Zorginformatiebouwstenen zijn opgesteld vanuit de gedachte dat dezelfde informatie zowel voor artsen, verpleegkundigen, paramedici als patiënten relevant zijn, ieder met hun eigen invalshoek.

Naast deze zorginformatiebouwstenen heeft het programma 'Registratie aan de Bron' ook de zogenaamde '[https://www.nictiz.nl/standaarden/basisgegevensset-zorg Basisgegevensset Zorg]' gedefinieerd. De Basisgegevensset Zorg (BgZ) is de minimale set van patiëntgegevens die specialisme-, ziektebeeld- en beroepsgroepoverstijgend relevant is en van belang voor de continuïteit van zorg voor de patiënt. De Basisgegevensset Zorg is gedefinieerd met behulp van de zorginformatiebouwstenen: het is een ingeperkte set van het totaal aan ZIB's.

Iedereen heeft recht op inzage van gegevens die over jou zijn vastgelegd. MedMij gebruikt de BgZ als leidraad om de uitwisseling van informatie tussen patiënt en professional op gang te brengen. Soms gebruikt de BgZ slechts een deel van een bepaalde ZIB. MedMij kiest ervoor om wél altijd de volledige ZIB te definiëren, zodat contextonafhankelijke implementatie mogelijk wordt. Dit zorgt er ook voor dat interoperabiliteit mogelijk wordt.

Er is een uitzondering gemaakt voor het domein van medicatie. Een programma dat parallel loopt aan MedMij is 'Medicatieproces'. Dit programma heeft de informatiestandaard Medicatieproces versie 9.x opgeleverd en nieuwe zorginformatiebouwstenen gedefinieerd. Deze nieuwe zorginformatiebouwstenen zijn geen onderdeel van BgZ 1.0, maar zijn wél in gebruik voor de functionele definitie voor het uitwisselen van medicatiegegevens in MedMij.

===Infrastructuur===
De berichten beschreven in deze informatiestandaard kunnen over elke willekeurige infrastructuur worden getransporteerd. De specificatie van de infrastructuur en het berichttransport is buiten scope van deze informatiestandaard.

MedMij kent wel een [http://www.medmij.nl/afsprakenstelsel/ afsprakenstelsel] met spelregels die zorgen dat de gegevensuitwisseling veilig is, privacy geborgd is en dat systemen aan juridische eisen voldoen.

===Geografische reikwijdte===
De geografische scope van alle ontwerpen van MedMij is Nederland.

==Kwalificatie==
Op deze informatiestandaard is een Nictiz kwalificatie van toepassing.
Kwalificatie vindt plaats per systeemrol.

Enkele systeemrollen vallen binnen de 'subsidieregeling voor PGO-leveranciers (dienstverlener persoon)' die in 2018 is opgesteld door de Dienst Uitvoering Subsidie voor Instellingen. Welke systeemrollen dat betreft vindt u [[MedMij:V2018.04_ToelichtingSubsidie| hier]].

Voor meer informatie over kwalificatie zie [https://www.nictiz.nl/standaardisatie/kwalificaties de websitepagina over Nictiz kwalificaties].

=Wiki structuuroverzicht=
Onderstaande afbeelding geeft een overzicht van de MedMij wiki pagina structuur. Het afsprakenstelsel verwijst naar de MedMij landingspagina die op zijn beurt verwijst naar de functionele en technische ontwerpen. Vanaf deze pagina, de hoofdpagina van de functionele ontwerpen, wordt verwezen naar de onderliggende functionele ontwerp pagina's middels de onderstaande 'patient journeys' en tabel overzicht. De functionele ontwerp beschrijvingen hebben een technische wiki pagina als tegenhanger. Vanuit de leeswijzer afbeelding, bestaande uit drie iconen, bovenaan de pagina is het mogelijk makkelijk door te linken naar de technische pagina's.

[[Bestand:MedMij wiki structuur overzicht.png|link= |650px|MedMij Wiki structuur overzicht]]

=Ontwerpen=
Patient journeys beschrijven de mogelijkheden die MedMij biedt vanuit het perspectief van een fictieve patiënt. Deze paragraaf start met de [[#Patient_journeys| Patient journeys]] die MedMij hanteert.

De paragraaf vervolgt met een index in tabelvorm gesplitst naar de use cases van het afsprakenstelsel:
* [[#Haal_gegevens_op_uit_XIS|Haal gegevens op uit XIS]]
* [[#Stuur_gegevens_naar_XIS|Stuur gegevens naar XIS]]
==Patient journeys==
===Thomas van Beek===
De beschrijving van de casus van de fictieve patiënt Thomas van Beek vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Onderstaand een grafische weergave van de tijdlijn van Thomas. Het is mogelijk te klikken op de groene PGO-cirkels, deze linken - indien beschikbaar - naar ontwerpspecificaties.
<imagemap>Bestand:journey-02.png|alt=Tijdlijn van Thomas. Het is mogelijk te klikken op de groene PGO-cirkels. | 1100px

circle 553 322 90 [[MedMij:V2018.04_OntwerpeAfspraak|eAfspraak]]
circle 1151 120 91 [[MedMij:Verwijzingen|Verwijzingen]]
circle 1941 155 91 [[MedMij:V2018.04_OntwerpMedicatie#Use_case:_Raadplegen_medicatieoverzicht_door_pati.C3.ABnt|Medicatieoverzicht]]
circle 1644 1296 91 [[MedMij:V2018.04_OntwerpBGZ_2017#Use_case_1:_Raadplegen_Basisgegevensset_Zorg_in_persoonlijke_gezondheidsomgeving|Basisgegevensset Zorg]]
circle 1302 1273 91 [[MedMij:vdraft_OntwerpBeelden|Beelden]]
circle 930 1161 91 [[MedMij:V2018.04_OntwerpLabresult#Use_case:_Raadplegen_laboratoriumresultaten_in_persoonlijke_gezondheidsomgeving|Laboratoriumresultaten]]
circle 629 1320 91 [[MedMij:V2018.04_OntwerpLabresult#Use_case:_Raadplegen_laboratoriumresultaten_in_persoonlijke_gezondheidsomgeving|Laboratoriumresultaten]]
desc none
</imagemap>

===Roos Dalstra===
De beschrijving van de casus van de fictieve patiënt Roos Dalstra vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Roos_Dalstra_MedMij.pdf hier].

Onderstaand een grafische weergave van de tijdlijn van Roos. Het is mogelijk te klikken op de groene PGO-cirkels, deze linken - indien beschikbaar - naar ontwerpspecificaties.

<imagemap>Bestand:Patient Journey - Roos Dalstra_20180109_2000.png|alt=Tijdlijn van Roos Dalstra. Het is mogelijk te klikken op de groene PGO-cirkels. | 1100px

circle 608 380 73 [[MedMij:V2018.04_OntwerpZelfmetingen|Zelfmetingen]]
circle 952 235 73 [[MedMij:V2018.04_OntwerpMedicatie#Use_case:_Raadplegen_medicatieoverzicht_door_pati.C3.ABnt|Medicatieoverzicht]]
circle 1237 422 74 [[MedMij:V2018.04_OntwerpHuisartsgegevens|Huisartsgegevens]]
circle 1605 111 74 [[MedMij:V2018.04_OntwerpAllergieIntolerantie|Allergie intolerantie]]
circle 707 912 74 [[MedMij:V2018.04_OntwerpeAfspraak|eAfspraak]]
circle 1195 1141 74 [[MedMij:V2018.04_OntwerpMedicatie|Medicatie]]
circle 1412 1139 74 [[MedMij:V2018.04_OntwerpLabresult|Laboratoriumresultaten]]
circle 1692 1074 74 [[MedMij:V2018.04_OntwerpPDFA|PDF/A]]
desc none
</imagemap>

==Haal gegevens op uit XIS==

Een persoonlijke gezondheidsomgeving (PGO) haalt gegevens op bij een zorginformatiesystemen (XIS). Onderstaande tabel geeft een overzicht van de use cases uit informatiestandaarden die van toepassing zijn voor het raadplegen van informatie.

{| class="wikitable"
| style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="6" | Index raadplegen / beschikbaar stellen
|-style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;"
|style="width:200px; border: 1px solid black;" colspan="2"| Informatiestandaard
|style="width:20px; border: 1px solid black;"| Versie
|style="width:600px; border: 1px solid black;"| Use case
|style="width:200px; border: 1px solid black;"| Functioneel
|style="width:200px; border: 1px solid black;"| Technisch
|-style="background-color: white;"
|[[Bestand:BGZ_icoon_zonder_tekst.png|link=https://www.nictiz.nl/standaarden/basisgegevensset-zorg|Basissetgegevens Zorg|49px]]||[https://www.nictiz.nl/standaarden/basisgegevensset-zorg Basisgegevensset Zorg]||||[https://www.nictiz.nl/standaarden/basisgegevensset-zorg Basisgegevensset Zorg], op basis van ZIB's release 2017||[[MedMij:V2018.04_OntwerpBGZ_2017#Use_case_1:_Raadplegen_Basisgegevensset_Zorg_in_persoonlijke_gezondheidsomgeving|BgZ]]||[[MedMij:V2018.04_FHIR_BGZ_2017|BgZ in FHIR]]
|-
|[[Bestand:Lab.png|link=https://www.nictiz.nl/standaardisatie/informatiestandaarden/laboratoria|Labuitwisseling|49px]]||[https://www.nictiz.nl/standaardisatie/informatiestandaarden/laboratoria Labuitwisseling]||||Laboratoriumresultaten ||[[MedMij:V2018.04_OntwerpLabresult#Use_case:_Raadplegen_laboratoriumresultaten_in_persoonlijke_gezondheidsomgeving|Laboratoriumresultaten]]||[[MedMij:V2018.04_FHIR_LaboratoryResults|Laboratoriumresultaten in FHIR]]
|-style="background-color: white;"
|rowspan="2"|[[Bestand:Medicatie.png|49px]]
|rowspan="2"|[https://www.nictiz.nl/Paginas/Informatiestandaard-Medicatieproces.aspx Medicatieproces]
|rowspan="2"|
||Medicatieoverzicht
||[[MedMij:V2018.04_OntwerpMedicatie#Use_case:_Raadplegen_medicatieoverzicht_in_persoonlijke_gezondheidsomgeving|Medicatieoverzicht]]
||[[MedMij:V2018.04_FHIR_MedicationProcess#Use_case:_retrieve_medication_overview |Medicatieoverzicht in FHIR]]
|-style="background-color: white;"
||Medicatiegegevens ||[[MedMij:V2018.04_OntwerpMedicatie#Use_case:_Raadplegen_medicatiegegevens_door_pati.C3.ABnt|Medicatiegegevens]]
||[[MedMij:V2018.04_FHIR_MedicationProcess#Use_case:_retrieve_medication_information |Medicatiegegevens in FHIR]]
|-
|[[Bestand:Allergie.png|link=https://www.nictiz.nl/standaardisatie/informatiestandaarden/medicatieveiligheid| Medicatieveiligheid|49px]]|||[https://www.nictiz.nl/standaardisatie/informatiestandaarden/medicatieveiligheid Medicatieveiligheid]
|||Allergie/intolerantie ||[[MedMij:V2018.04_OntwerpAllergieIntolerantie| AllergieIntolerantie]] ||[[MedMij:V2018.04_FHIR_AllergyIntolerance|AllergieIntolerantie in FHIR]]
|-style="background-color: white;"
|[[Bestand:EAfspraak_icoon_zonder_tekst.png|link=MedMij:V2018.04_OntwerpeAfspraak|49px]]
||eAfspraak
||||Afspraken raadplegen
||[[MedMij:V2018.04_OntwerpeAfspraak#Use_case:_Afspraak_raadplegen_door_pati.C3.ABnt| eAfspraak]]
|| [[MedMij:V2018.04_FHIR_eAfspraak| eAfspraak in FHIR]]
|-
|[[Bestand:Self-Measuements_zonder_tekst.png|link=|49px]]
||Zelfmetingen
||||Zelfmetingen raadplegen||[[MedMij:V2018.04_OntwerpZelfmetingen|Zelfmetingen]]||[[MedMij:V2018.04_FHIR_VitalSigns|Zelfmetingen in FHIR]]
|-style="background-color: white;"
|[[Bestand:PDF-A_icoon_zonder_tekst.png|PDF/A|49px]]
||PDF/A
||||PDF/A raadplegen ||[[MedMij:V2018.04_OntwerpPDFA| PDF/A]] ||[[MedMij:V2018.04_FHIR_PDFA|PDF/A in FHIR]]
|-
|-
|[[Bestand:BeeldenIcoon.png|link=|Beelden|50px]]||||||Beelden|||[[MedMij:V2018.04_OntwerpBeelden| Beelden]]||[[MedMij:V2018.04_FHIR_Images| Beelden in FHIR]]
|-
|[[Bestand:Huisartsgegevens.png|49px|Huisartsgegevens]]||Huisartsgegevens|||| Huisartsgegevens || [[MedMij:V2018.04_OntwerpHuisartsgegevens|Huisartsgegevens]] ||[[MedMij:V2018.04_FHIR_GP_Data|GP Data in FHIR]]
|-style="background-color: white;"
|[[Bestand:Indicatiebesluit_icoon_zonder_tekst.png|49px|Indicatiestelling]]||||||Indicatiestelling || ||
|}

==Stuur gegevens naar XIS==
Een persoonlijke gezondheidsomgeving (PGO) stuurt gegevens naar een zorginformatiesystemen (XIS). Onderstaande tabel geeft een overzicht van de use cases uit informatiestandaarden die van toepassing zijn voor het sturen van informatie.

{| class="wikitable"
| style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="6" | Index sturen / ontvangen
|-style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;"
|style="width:200px; border: 1px solid black;" colspan="2"| Informatiestandaard
|style="width:20px; border: 1px solid black;"| Versie
|style="width:600px; border: 1px solid black;"| Use case
|style="width:200px; border: 1px solid black;"| Functioneel
|style="width:200px; border: 1px solid black;"| Technisch
|-
|[[Bestand:Lab.png|link=https://www.nictiz.nl/standaardisatie/informatiestandaarden/laboratoria|Labuitwisseling|50px]]||[https://www.nictiz.nl/standaardisatie/informatiestandaarden/laboratoria Labuitwisseling]
||||Laboratoriumresultaat (bijvoorbeeld: zelfmeting) ||||[[MedMij:V2018.04_FHIR_LaboratoryResults|Lab resultaat in FHIR]]

|-style="background-color: white;"
|[[Bestand:Self-Measuements_zonder_tekst.png|link=|50px]]||Zelfmetingen||||Zelfmetingen sturen||[[MedMij:V2018.04_OntwerpZelfmetingen#Use_case:_Sturen_zelfmetingen_van_de_vitale_functies_door_pati.C3.ABnt|Zelfmetingen]]||[[MedMij:V2018.04_FHIR_VitalSigns|Zelfmetingen in FHIR]]
|-
|rowspan="3"|[[Bestand:EAfspraak_icoon_zonder_tekst.png|link=MedMij:V2018.04_OntwerpeAfspraak|50px]]
|rowspan="3"|eAfspraak
|rowspan="3"|
||Afspraak maken
||[[MedMij:V2018.04_OntwerpeAfspraak#Use_case:_Afspraak_maken_door_pati.C3.ABnt| eAfspraak maken]]
||
|-
|Afspraak annuleren
||[[MedMij:V2018.04_OntwerpeAfspraak#Use_case:_Afspraak_annuleren_door_pati.C3.ABnt| eAfspraak annuleren]]
||
|-
|Afspraak wijzigen
||[[MedMij:V2018.04_OntwerpeAfspraak#Use_case:_Afspraak_wijzigen_door_pati.C3.ABnt| eAfspraak wijzigen]]
||
|-style="background-color: white;"
|[[Bestand:PDF-A_icoon_zonder_tekst.png|link=|PDF/A|50px]]||PDF/A||||PDF/A|||[[MedMij:V2018.04_OntwerpPDFA#Use_case:_Sturen_medische_gegevens_in_PDF.2FA_door_pati.C3.ABnt| PDF/A]]||[[MedMij:V2018.04_FHIR_PDFA| PDF/A in FHIR]]
|-
|[[Bestand:BeeldenIcoon.png|link=|Beelden|50px]]||Beelden||||Beelden|||[[MedMij:V2018.04_OntwerpBeelden| Beelden]]||[[MedMij:V2018.04_FHIR_Images| Beelden in FHIR]]
|}

=Systeemrollen=
In onderstaande tabel zijn alle systeemrollen opgenomen die van toepassing zijn in de MedMij use cases. De syteemrolcode is gebaseerd op de informatiestandaard inclusief versie, de transactie en uitwisselingsstandaard. De code is als volgt opgebouwd: afkorting informatiestandaard - versie - afkorting transactie - uitwisselingsstandaard. Wanneer er geen informatiestandaard beschikbaar is, wordt de afkorting MM (MedMij) gebruikt.

De kolom 'Afsprakenstelsel release' geeft informatie over de versie van het afsprakenstelsel waarin de systeemrol is opgenomen. Wanneer een systeemrol geen afsprakenstelsel releasenummer heeft betekent dat deze nog niet is opgenomen.

De kolom 'MMVN' geeft een indicatie van de volwassenheid van de standaarden, conform verschillende MedMij VolwassenheidsNiveaus (MMVN) die binnen het afsprakenstelsel worden onderscheiden. Standaarden krijgen een MedMij niveau als ze ook daadwerkelijk toegepast kunnen worden binnen MedMij Afsprakenstelsel. Vooralsnog valt PUSH daar bijvoorbeeld buiten, en hebben systeemrollen van PUSH transactiegroepen een MMVN van '0'. Nadere toelichting ten aanzien van MedMij VolwassenheidNiveaus vindt u in [http://www.medmij.nl/wp-content/uploads/2017/11/Co%C3%B6rdinatie-standaarden-MedMij-Governance.pdf het document Coördinatie standaarden MedMij – Governance].

{| class="wikitable"
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" colspan=2 |Informatiestandaard
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Transactiegroep
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Transactie
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Systeem
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Systemrolcode
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Afsprakenstelsel release
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |MMVN
|-
| rowspan="2" | [[Bestand:BGZ_icoon_zonder_tekst.png|link=https://www.nictiz.nl/standaarden/basisgegevensset-zorg|Basissetgegevens Zorg|50px]]
| rowspan="2" | Basisgegevensset Zorg
| rowspan="2" | BgZ (PULL)
| Raadplegen BgZ
| PGO
| MM-2.0.0-BZR-FHIR
| R1.0
| 3
|-
| Beschikbaar stellen BgZ
| XIS
| MM-2.0.0-BZB-FHIR
| R1.0
| 3
|-
| rowspan="4" | [[Bestand:Medicatie.png|https://www.nictiz.nl/Paginas/Informatiestandaard-Medicatieproces.aspx| Medicatieproces|50px]]
| rowspan="4" | Medicatieproces
| rowspan="2" | Medicatieoverzicht (PULL)
| Raadplegen medicatieoverzicht
| PGO
| MP-9.0.6-MOR-FHIR
| R1.0
| 3
|-
| Beschikbaar stellen medicatieoverzicht
| XIS
| MP-9.0.6-MOB-FHIR
| R1.0
| 3
|-
| rowspan="2" | Medicatiegegevens (PULL)
| Raadplegen medicatiegegevens
| PGO
| MP-9.0.6-MGR-FHIR
| R1.0
| 3
|-
| Beschikbaar stellen medicatiegegevens
| XIS
| MP-9.0.6-MGB-FHIR
| R1.0
| 3
|-
| rowspan="2" | [[Bestand:Lab.png|link=https://www.nictiz.nl/standaardisatie/informatiestandaarden/laboratoria|Labuitwisseling|50px]]
| rowspan="2" | Labuitwisseling
| rowspan="2" | Laboratoriumresultaten (PULL)
| Raadplegen laboratoriumresultaten
| PGO
| LAB-1.0.0-LRR-FHIR
| R1.0
| 3
|-
| Beschikbaar stellen laboratoriumresultaten
| XIS
| LAB-1.0.0-LRB-FHIR
| R1.0
| 3
|-
| rowspan="4" | [[Bestand:Self-Measuements_zonder_tekst.png|link=|50px]]
| rowspan="4" | Zelfmetingen
| rowspan="2" | Meetwaarden vitale functies (PULL)
| Raadplegen meetwaarden vitale functies
| PGO
| MM-1.0.0-MVR-FHIR
| R1.0
| 3
|-
| Beschikbaar stellen meetwaarden vitale functies
| XIS
| MM-1.0.0-MVB-FHIR
| R1.0
| 3
|-
| rowspan="2" | Zelfmetingen vitale functies (PUSH)
| Sturen zelfmetingen van vitale functies
| PGO
| MM-1.0.0-ZVS-FHIR
| R1.1
| 3
|-
| Ontvangen zelfmetingen vitale functies
| XIS
| MM-1.0.0-ZVO-FHIR
| R1.1
| 3
|-
| rowspan="6" | [[Bestand:PDF-A_icoon_zonder_tekst.png|link=|PDF/A|50px]]
| rowspan="6" | PDF/A
| rowspan="2" | PDFA metadata lijst (PULL)
| Raadplegen PDF/A metadata lijst
| PGO
| MM-1.0.0-PDR-FHIR
| R1.0
| 3
|-
| Beschikbaar stellen PDF/A metadata lijst
| XIS
| MM-1.0.0-PDB-FHIR
| R1.0
| 3
|-
| rowspan="2" | PDFA (PULL)
| Raadplegen PDF/A
| PGO
| MM-1.0.0-PDR-FHIR
| R1.0
| 3
|-
| Beschikbaar stellen PDF/A
| XIS
| MM-1.0.0-PDB-FHIR
| R1.0
| 3
|-
| rowspan="2" | PDFA (PUSH)
| Sturen PDF/A
| PGO
| MM-1.0.0-PDS-FHIR
| R1.1
| 3
|-
| Ontvangen PDF/A
| XIS
| MM-1.0.0-PDO-FHIR
| R1.1
| 3
|-
| rowspan="2" | [[Bestand:Allergie.png|link=https://www.nictiz.nl/standaardisatie/informatiestandaarden/medicatieveiligheid| Medicatieveiligheid|50px]]
| rowspan="2" | Medicatieveiligheid
| rowspan="2" | AllergieIntolerantie gegevens (PULL)
| Raadplegen AllergieIntolerantie gegevens
| PGO
| MP-6.12.6-AIR-FHIR
| R1.0
| 3
|-
| Beschikbaar stellen AllergieIntolerantie gegevens
| XIS
| MP-6.12.6-AIB-FHIR
| R1.0
| 3
|-
| rowspan="12" | [[Bestand:EAfspraak_icoon_zonder_tekst.png|link=MedMij:V2018.04_OntwerpeAfspraak|50px]]
| rowspan="12" | eAfspraak
| rowspan="2" | Afspraken (PULL)
| Raadplegen afspraak
| PGO
| EA-1.0.0-AFR-FHIR
| R1.0
| 3
|-
| Beschikbaar stellen afspraak
| XIS
| EA-1.0.0-AFB-FHIR
| R1.0
| 3
|-
| rowspan="2" | AfspraakSlots (PULL)
| Raadplegen afspraak slots
| PGO
| EA-1.0.0-ASR-FHIR
| R1.1
| 1
|-
| Beschikbaar stellen afspraak slots
| XIS
| EA-1.0.0-ASB-FHIR
| R1.1
| 1
|-
| rowspan="2" | AfspraakType (PULL)
| Raadplegen afspraak typen
| PGO
| EA-1.0.0-ATR-FHIR
| R1.1
| 1
|-
| Beschikbaar stellen afspraak typen
| XIS
| EA-1.0.0-ATB-FHIR
| R1.1
| 1
|-
| rowspan="2" | AfspraakVerzoek (PUSH)
| Sturen afspraakverzoek
| PGO
| EA-1.0.0-AVS-FHIR
| R1.1
| 1
|-
| Ontvangen afspraakverzoek
| XIS
| EA-1.0.0-AVO-FHIR
| R1.1
| 1
|-
| rowspan="2" | AfspraakAnnulering (PUSH)
| Sturen afspraak annulering
| PGO
| EA-1.0.0-AAS-FHIR
| R1.1
| 1
|-
| Ontvangen afspraak annulering
| XIS
| EA-1.0.0-AAO-FHIR
| R1.1
| 1
|-
| rowspan="2" | AfspraakWijziging (PUSH)
| Sturen afspraak wijzigingsverzoek
| PGO
| EA-1.0.0-AWS-FHIR
| R1.1
| 1
|-
| Ontvangen afspraak wijzigingsverzoek
| XIS
| EA-1.0.0-AWO-FHIR
| R1.1
| 1
|-
| rowspan="2" | [[Bestand:Huisartsgegevens.png|link=MedMij:V2018.04_OntwerpHuisartsgegevens|Huisartsgegevens|50px]]
| rowspan="2" | Huisartsgegevens
| rowspan="2" | Huisartsgegevens (PULL)
| Raadplegen Huisartsgegevens
| PGO
| MM-1.0.0-HGR-FHIR
| R1.1
| 1
|-
| Beschikbaar stellen Huisartsgegevens
| XIS
| MM-1.0.0-HGB-FHIR
| R1.1
| 1
|}

=Release Notes=

{| class="wikitable"
! Versie !! Datum !! Omschrijving
|-
| [[MedMij:V2018.04_Ontwerpen|2018.04]] || 2018-08-30 || eAfspraak fase 2
|-
| [[MedMij:V2018.03_Ontwerpen|2018.03]] || 2018-05-07 || BgZ 2017 en Huisartsgegevens
|-
| [[MedMij:V2018.02_Ontwerpen|2018.02]] || 2018-03-29 || BgZ 2017 voor openbare consultatie
|-
| [[MedMij:V2018.01_Ontwerpen|2018.01]] || 2018-02-21 || Huisartsgegevens voor openbare consultatie
|-
| [[MedMij:V2017.04_Ontwerpen|2017.04]] || 2017-12-18 || Medicatie, Laboratoriumresultaten, Allergie/intolerantie, Zelfmetingen
|-
| [[MedMij:V2017.03_Ontwerpen|2017.03]] || 2017-11-07 || PDF/A
|-
| [[MedMij:V2017.02_Ontwerpen|2017.02]] || 2017-10-11 || eAfspraak
|-
| [[MedMij:V2017.01_Ontwerpen|2017.01]] || 2017-10-02 || BgZ 2015
|}

MedMij:V2018.04 Ontwerpen

2018-08-30T14:05:05Z

Marten Smits:

{{#customtitle:Ontwerpen MedMij|Functioneel Ontwerpen}}
{{IssueBox|Dit is een werkpagina.

De gepubliceerde versie kan hier gevonden worden: https://informatiestandaarden.nictiz.nl/wiki/MedMij:Vcurrent_Ontwerpen}}
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.04_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.04_FHIR_IG|Technisch]]
desc none
</imagemap>

=Inleiding=
==Algemeen==
Hier vindt u informatie over de ''inhoud'' van de informatie die kan worden uitgewisseld in het [https://www.medmij.nl/afsprakenstelsel/ MedMij afsprakenstelstel].

Deze pagina beschrijft allereerst de algemeen geldende en overkoepelende informatie van de functionele ontwerpen voor MedMij en bevat vervolgens [[#Ontwerpen|verwijzingen]] naar specifieke functionele ontwerpen en technische specificaties voor die use cases die onderdeel zijn van het afsprakenstelsel.

==Doelgroep==
De doelgroep voor deze pagina bestaat uit:
* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz;
* Vertegenwoordigers van patiënten, laboratoria en zorgverleners.

==Kaders en uitgangspunten==

===Richtlijn===
Het programma '[https://www.registratieaandebron.nl Registratie aan de bron]' heeft zorginformatiebouwstenen voor Nederland gedefinieerd. Een zorginformatiebouwsteen (ZIB) beschrijft nauwkeurig wat er over een bepaald onderwerp van het zorgproces van de patiënt moet worden vastgelegd. Zorginformatiebouwstenen zijn opgesteld vanuit de gedachte dat dezelfde informatie zowel voor artsen, verpleegkundigen, paramedici als patiënten relevant zijn, ieder met hun eigen invalshoek.

Naast deze zorginformatiebouwstenen heeft het programma 'Registratie aan de Bron' ook de zogenaamde '[https://www.nictiz.nl/standaarden/basisgegevensset-zorg Basisgegevensset Zorg]' gedefinieerd. De Basisgegevensset Zorg (BgZ) is de minimale set van patiëntgegevens die specialisme-, ziektebeeld- en beroepsgroepoverstijgend relevant is en van belang voor de continuïteit van zorg voor de patiënt. De Basisgegevensset Zorg is gedefinieerd met behulp van de zorginformatiebouwstenen: het is een ingeperkte set van het totaal aan ZIB's.

Iedereen heeft recht op inzage van gegevens die over jou zijn vastgelegd. MedMij gebruikt de BgZ als leidraad om de uitwisseling van informatie tussen patiënt en professional op gang te brengen. Soms gebruikt de BgZ slechts een deel van een bepaalde ZIB. MedMij kiest ervoor om wél altijd de volledige ZIB te definiëren, zodat contextonafhankelijke implementatie mogelijk wordt. Dit zorgt er ook voor dat interoperabiliteit mogelijk wordt.

Er is een uitzondering gemaakt voor het domein van medicatie. Een programma dat parallel loopt aan MedMij is 'Medicatieproces'. Dit programma heeft de informatiestandaard Medicatieproces versie 9.x opgeleverd en nieuwe zorginformatiebouwstenen gedefinieerd. Deze nieuwe zorginformatiebouwstenen zijn geen onderdeel van BgZ 1.0, maar zijn wél in gebruik voor de functionele definitie voor het uitwisselen van medicatiegegevens in MedMij.

===Infrastructuur===
De berichten beschreven in deze informatiestandaard kunnen over elke willekeurige infrastructuur worden getransporteerd. De specificatie van de infrastructuur en het berichttransport is buiten scope van deze informatiestandaard.

MedMij kent wel een [http://www.medmij.nl/afsprakenstelsel/ afsprakenstelsel] met spelregels die zorgen dat de gegevensuitwisseling veilig is, privacy geborgd is en dat systemen aan juridische eisen voldoen.

===Geografische reikwijdte===
De geografische scope van alle ontwerpen van MedMij is Nederland.

==Kwalificatie==
Op deze informatiestandaard is een Nictiz kwalificatie van toepassing.
Kwalificatie vindt plaats per systeemrol.

Enkele systeemrollen vallen binnen de 'subsidieregeling voor PGO-leveranciers (dienstverlener persoon)' die in 2018 is opgesteld door de Dienst Uitvoering Subsidie voor Instellingen. Welke systeemrollen dat betreft vindt u [[MedMij:V2018.04_ToelichtingSubsidie| hier]].

Voor meer informatie over kwalificatie zie [https://www.nictiz.nl/standaardisatie/kwalificaties de websitepagina over Nictiz kwalificaties].

=Wiki structuuroverzicht=
Onderstaande afbeelding geeft een overzicht van de MedMij wiki pagina structuur. Het afsprakenstelsel verwijst naar de MedMij landingspagina die op zijn beurt verwijst naar de functionele en technische ontwerpen. Vanaf deze pagina, de hoofdpagina van de functionele ontwerpen, wordt verwezen naar de onderliggende functionele ontwerp pagina's middels de onderstaande 'patient journeys' en tabel overzicht. De functionele ontwerp beschrijvingen hebben een technische wiki pagina als tegenhanger. Vanuit de leeswijzer afbeelding, bestaande uit drie iconen, bovenaan de pagina is het mogelijk makkelijk door te linken naar de technische pagina's.

[[Bestand:MedMij wiki structuur overzicht.png|link= |650px|MedMij Wiki structuur overzicht]]

=Ontwerpen=
Patient journeys beschrijven de mogelijkheden die MedMij biedt vanuit het perspectief van een fictieve patiënt. Deze paragraaf start met de [[#Patient_journeys| Patient journeys]] die MedMij hanteert.

De paragraaf vervolgt met een index in tabelvorm gesplitst naar de use cases van het afsprakenstelsel:
* [[#Haal_gegevens_op_uit_XIS|Haal gegevens op uit XIS]]
* [[#Stuur_gegevens_naar_XIS|Stuur gegevens naar XIS]]
==Patient journeys==
===Thomas van Beek===
De beschrijving van de casus van de fictieve patiënt Thomas van Beek vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Onderstaand een grafische weergave van de tijdlijn van Thomas. Het is mogelijk te klikken op de groene PGO-cirkels, deze linken - indien beschikbaar - naar ontwerpspecificaties.
<imagemap>Bestand:journey-02.png|alt=Tijdlijn van Thomas. Het is mogelijk te klikken op de groene PGO-cirkels. | 1100px

circle 553 322 90 [[MedMij:V2018.04_OntwerpeAfspraak|eAfspraak]]
circle 1151 120 91 [[MedMij:Verwijzingen|Verwijzingen]]
circle 1941 155 91 [[MedMij:V2018.04_OntwerpMedicatie#Use_case:_Raadplegen_medicatieoverzicht_door_pati.C3.ABnt|Medicatieoverzicht]]
circle 1644 1296 91 [[MedMij:V2018.04_OntwerpBGZ_2017#Use_case_1:_Raadplegen_Basisgegevensset_Zorg_in_persoonlijke_gezondheidsomgeving|Basisgegevensset Zorg]]
circle 1302 1273 91 [[MedMij:vdraft_OntwerpBeelden|Beelden]]
circle 930 1161 91 [[MedMij:V2018.04_OntwerpLabresult#Use_case:_Raadplegen_laboratoriumresultaten_in_persoonlijke_gezondheidsomgeving|Laboratoriumresultaten]]
circle 629 1320 91 [[MedMij:V2018.04_OntwerpLabresult#Use_case:_Raadplegen_laboratoriumresultaten_in_persoonlijke_gezondheidsomgeving|Laboratoriumresultaten]]
desc none
</imagemap>

===Roos Dalstra===
De beschrijving van de casus van de fictieve patiënt Roos Dalstra vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Roos_Dalstra_MedMij.pdf hier].

Onderstaand een grafische weergave van de tijdlijn van Roos. Het is mogelijk te klikken op de groene PGO-cirkels, deze linken - indien beschikbaar - naar ontwerpspecificaties.

<imagemap>Bestand:Patient Journey - Roos Dalstra_20180109_2000.png|alt=Tijdlijn van Roos Dalstra. Het is mogelijk te klikken op de groene PGO-cirkels. | 1100px

circle 608 380 73 [[MedMij:V2018.04_OntwerpZelfmetingen|Zelfmetingen]]
circle 952 235 73 [[MedMij:V2018.04_OntwerpMedicatie#Use_case:_Raadplegen_medicatieoverzicht_door_pati.C3.ABnt|Medicatieoverzicht]]
circle 1237 422 74 [[MedMij:V2018.04_OntwerpHuisartsgegevens|Huisartsgegevens]]
circle 1605 111 74 [[MedMij:V2018.04_OntwerpAllergieIntolerantie|Allergie intolerantie]]
circle 707 912 74 [[MedMij:V2018.04_OntwerpeAfspraak|eAfspraak]]
circle 1195 1141 74 [[MedMij:V2018.04_OntwerpMedicatie|Medicatie]]
circle 1412 1139 74 [[MedMij:V2018.04_OntwerpLabresult|Laboratoriumresultaten]]
circle 1692 1074 74 [[MedMij:V2018.04_OntwerpPDFA|PDF/A]]
desc none
</imagemap>

==Haal gegevens op uit XIS==

Een persoonlijke gezondheidsomgeving (PGO) haalt gegevens op bij een zorginformatiesystemen (XIS). Onderstaande tabel geeft een overzicht van de use cases uit informatiestandaarden die van toepassing zijn voor het raadplegen van informatie.

{| class="wikitable"
| style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="6" | Index raadplegen / beschikbaar stellen
|-style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;"
|style="width:200px; border: 1px solid black;" colspan="2"| Informatiestandaard
|style="width:20px; border: 1px solid black;"| Versie
|style="width:600px; border: 1px solid black;"| Use case
|style="width:200px; border: 1px solid black;"| Functioneel
|style="width:200px; border: 1px solid black;"| Technisch
|-style="background-color: white;"
|[[Bestand:BGZ_icoon_zonder_tekst.png|link=https://www.nictiz.nl/standaarden/basisgegevensset-zorg|Basissetgegevens Zorg|49px]]||[https://www.nictiz.nl/standaarden/basisgegevensset-zorg Basisgegevensset Zorg]||||[https://www.nictiz.nl/standaarden/basisgegevensset-zorg Basisgegevensset Zorg], op basis van ZIB's release 2017||[[MedMij:V2018.04_OntwerpBGZ_2017#Use_case_1:_Raadplegen_Basisgegevensset_Zorg_in_persoonlijke_gezondheidsomgeving|BgZ]]||[[MedMij:V2018.04_FHIR_BGZ_2017|BgZ in FHIR]]
|-
|[[Bestand:Lab.png|link=https://www.nictiz.nl/standaardisatie/informatiestandaarden/laboratoria|Labuitwisseling|49px]]||[https://www.nictiz.nl/standaardisatie/informatiestandaarden/laboratoria Labuitwisseling]||||Laboratoriumresultaten ||[[MedMij:V2018.04_OntwerpLabresult#Use_case:_Raadplegen_laboratoriumresultaten_in_persoonlijke_gezondheidsomgeving|Laboratoriumresultaten]]||[[MedMij:V2018.04_FHIR_LaboratoryResults|Laboratoriumresultaten in FHIR]]
|-style="background-color: white;"
|rowspan="2"|[[Bestand:Medicatie.png|49px]]
|rowspan="2"|[https://www.nictiz.nl/Paginas/Informatiestandaard-Medicatieproces.aspx Medicatieproces]
|rowspan="2"|
||Medicatieoverzicht
||[[MedMij:V2018.04_OntwerpMedicatie#Use_case:_Raadplegen_medicatieoverzicht_in_persoonlijke_gezondheidsomgeving|Medicatieoverzicht]]
||[[MedMij:V2018.04_FHIR_MedicationProcess#Use_case:_retrieve_medication_overview |Medicatieoverzicht in FHIR]]
|-style="background-color: white;"
||Medicatiegegevens ||[[MedMij:V2018.04_OntwerpMedicatie#Use_case:_Raadplegen_medicatiegegevens_door_pati.C3.ABnt|Medicatiegegevens]]
||[[MedMij:V2018.04_FHIR_MedicationProcess#Use_case:_retrieve_medication_information |Medicatiegegevens in FHIR]]
|-
|[[Bestand:Allergie.png|link=https://www.nictiz.nl/standaardisatie/informatiestandaarden/medicatieveiligheid| Medicatieveiligheid|49px]]|||[https://www.nictiz.nl/standaardisatie/informatiestandaarden/medicatieveiligheid Medicatieveiligheid]
|||Allergie/intolerantie ||[[MedMij:V2018.04_OntwerpAllergieIntolerantie| AllergieIntolerantie]] ||[[MedMij:V2018.04_FHIR_AllergyIntolerance|AllergieIntolerantie in FHIR]]
|-style="background-color: white;"
|[[Bestand:EAfspraak_icoon_zonder_tekst.png|link=MedMij:V2018.04_OntwerpeAfspraak|49px]]
||eAfspraak
||||Afspraken raadplegen
||[[MedMij:V2018.04_OntwerpeAfspraak#Use_case:_Afspraak_raadplegen_door_pati.C3.ABnt| eAfspraak]]
|| [[MedMij:V2018.04_FHIR_eAfspraak| eAfspraak in FHIR]]
|-
|[[Bestand:Self-Measuements_zonder_tekst.png|link=|49px]]
||Zelfmetingen
||||Zelfmetingen raadplegen||[[MedMij:V2018.04_OntwerpZelfmetingen|Zelfmetingen]]||[[MedMij:V2018.04_FHIR_VitalSigns|Zelfmetingen in FHIR]]
|-style="background-color: white;"
|[[Bestand:PDF-A_icoon_zonder_tekst.png|PDF/A|49px]]
||PDF/A
||||PDF/A raadplegen ||[[MedMij:V2018.04_OntwerpPDFA| PDF/A]] ||[[MedMij:V2018.04_FHIR_PDFA|PDF/A in FHIR]]
|-
|-
|[[Bestand:BeeldenIcoon.png|link=|Beelden|50px]]||||||Beelden|||[[MedMij:V2018.04_OntwerpBeelden| Beelden]]||[[MedMij:V2018.04_FHIR_Images| Beelden in FHIR]]
|-
|[[Bestand:Huisartsgegevens.png|49px|Huisartsgegevens]]||Huisartsgegevens|||| Huisartsgegevens || [[MedMij:V2018.04_OntwerpHuisartsgegevens|Huisartsgegevens]] ||[[MedMij:V2018.04_FHIR_GP_Data|GP Data in FHIR]]
|-style="background-color: white;"
|[[Bestand:Indicatiebesluit_icoon_zonder_tekst.png|49px|Indicatiestelling]]||||||Indicatiestelling || ||
|}

==Stuur gegevens naar XIS==
Een persoonlijke gezondheidsomgeving (PGO) stuurt gegevens naar een zorginformatiesystemen (XIS). Onderstaande tabel geeft een overzicht van de use cases uit informatiestandaarden die van toepassing zijn voor het sturen van informatie.

{| class="wikitable"
| style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="6" | Index sturen / ontvangen
|-style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;"
|style="width:200px; border: 1px solid black;" colspan="2"| Informatiestandaard
|style="width:20px; border: 1px solid black;"| Versie
|style="width:600px; border: 1px solid black;"| Use case
|style="width:200px; border: 1px solid black;"| Functioneel
|style="width:200px; border: 1px solid black;"| Technisch
|-
|[[Bestand:Lab.png|link=https://www.nictiz.nl/standaardisatie/informatiestandaarden/laboratoria|Labuitwisseling|50px]]||[https://www.nictiz.nl/standaardisatie/informatiestandaarden/laboratoria Labuitwisseling]
||||Laboratoriumresultaat (bijvoorbeeld: zelfmeting) ||||[[MedMij:V2018.04_FHIR_LaboratoryResults|Lab resultaat in FHIR]]

|-style="background-color: white;"
|[[Bestand:Self-Measuements_zonder_tekst.png|link=|50px]]||Zelfmetingen||||Zelfmetingen sturen||[[MedMij:V2018.04_OntwerpZelfmetingen#Use_case:_Sturen_zelfmetingen_van_de_vitale_functies_door_pati.C3.ABnt|Zelfmetingen]]||[[MedMij:V2018.04_FHIR_VitalSigns|Zelfmetingen in FHIR]]
|-
|rowspan="3"|[[Bestand:EAfspraak_icoon_zonder_tekst.png|link=MedMij:V2018.04_OntwerpeAfspraak|50px]]
|rowspan="3"|eAfspraak
|rowspan="3"|
||Afspraak maken
||[[MedMij:V2018.04_OntwerpeAfspraak#Use_case:_Afspraak_maken_door_pati.C3.ABnt| eAfspraak maken]]
||
|-
|Afspraak annuleren
||[[MedMij:V2018.04_OntwerpeAfspraak#Use_case:_Afspraak_annuleren_door_pati.C3.ABnt| eAfspraak annuleren]]
||
|-
|Afspraak wijzigen
||[[MedMij:V2018.04_OntwerpeAfspraak#Use_case:_Afspraak_wijzigen_door_pati.C3.ABnt| eAfspraak wijzigen]]
||
|-style="background-color: white;"
|[[Bestand:PDF-A_icoon_zonder_tekst.png|link=|PDF/A|50px]]||PDF/A||||PDF/A|||[[MedMij:V2018.04_OntwerpPDFA#Use_case:_Sturen_medische_gegevens_in_PDF.2FA_door_pati.C3.ABnt| PDF/A]]||[[MedMij:V2018.04_FHIR_PDFA| PDF/A in FHIR]]
|-
|[[Bestand:BeeldenIcoon.png|link=|Beelden|50px]]||Beelden||||Beelden|||[[MedMij:V2018.04_OntwerpBeelden| Beelden]]||[[MedMij:V2018.04_FHIR_Images| Beelden in FHIR]]
|}

=Systeemrollen=
In onderstaande tabel zijn alle systeemrollen opgenomen die van toepassing zijn in de MedMij use cases. De syteemrolcode is gebaseerd op de informatiestandaard inclusief versie, de transactie en uitwisselingsstandaard. De code is als volgt opgebouwd: afkorting informatiestandaard - versie - afkorting transactie - uitwisselingsstandaard. Wanneer er geen informatiestandaard beschikbaar is, wordt de afkorting MM (MedMij) gebruikt.

De kolom 'Afsprakenstelsel release' geeft informatie over de versie van het afsprakenstelsel waarin de systeemrol is opgenomen. Wanneer een systeemrol geen afsprakenstelsel releasenummer heeft betekent dat deze nog niet is opgenomen.

De kolom 'MMVN' geeft een indicatie van de volwassenheid van de standaarden, conform verschillende MedMij VolwassenheidsNiveaus (MMVN) die binnen het afsprakenstelsel worden onderscheiden. Standaarden krijgen een MedMij niveau als ze ook daadwerkelijk toegepast kunnen worden binnen MedMij Afsprakenstelsel. Vooralsnog valt PUSH daar bijvoorbeeld buiten, en hebben systeemrollen van PUSH transactiegroepen een MMVN van '0'. Nadere toelichting ten aanzien van MedMij VolwassenheidNiveaus vindt u in [http://www.medmij.nl/wp-content/uploads/2017/11/Co%C3%B6rdinatie-standaarden-MedMij-Governance.pdf het document Coördinatie standaarden MedMij – Governance].

{| class="wikitable"
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" colspan=2 |Informatiestandaard
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Transactiegroep
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Transactie
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Systeem
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Systemrolcode
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Afsprakenstelsel release
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |MMVN
|-
| rowspan="2" | [[Bestand:BGZ_icoon_zonder_tekst.png|link=https://www.nictiz.nl/standaarden/basisgegevensset-zorg|Basissetgegevens Zorg|50px]]
| rowspan="2" | Basisgegevensset Zorg
| rowspan="2" | BgZ (PULL)
| Raadplegen BgZ
| PGO
| MM-2.0.0-BZR-FHIR
| R1.0
| 3
|-
| Beschikbaar stellen BgZ
| XIS
| MM-2.0.0-BZB-FHIR
| R1.0
| 3
|-
| rowspan="4" | [[Bestand:Medicatie.png|https://www.nictiz.nl/Paginas/Informatiestandaard-Medicatieproces.aspx| Medicatieproces|50px]]
| rowspan="4" | Medicatieproces
| rowspan="2" | Medicatieoverzicht (PULL)
| Raadplegen medicatieoverzicht
| PGO
| MP-9.0.6-MOR-FHIR
| R1.0
| 3
|-
| Beschikbaar stellen medicatieoverzicht
| XIS
| MP-9.0.6-MOB-FHIR
| R1.0
| 3
|-
| rowspan="2" | Medicatiegegevens (PULL)
| Raadplegen medicatiegegevens
| PGO
| MP-9.0.6-MGR-FHIR
| R1.0
| 3
|-
| Beschikbaar stellen medicatiegegevens
| XIS
| MP-9.0.6-MGB-FHIR
| R1.0
| 3
|-
| rowspan="2" | [[Bestand:Lab.png|link=https://www.nictiz.nl/standaardisatie/informatiestandaarden/laboratoria|Labuitwisseling|50px]]
| rowspan="2" | Labuitwisseling
| rowspan="2" | Laboratoriumresultaten (PULL)
| Raadplegen laboratoriumresultaten
| PGO
| LAB-1.0.0-LRR-FHIR
| R1.0
| 3
|-
| Beschikbaar stellen laboratoriumresultaten
| XIS
| LAB-1.0.0-LRB-FHIR
| R1.0
| 3
|-
| rowspan="4" | [[Bestand:Self-Measuements_zonder_tekst.png|link=|50px]]
| rowspan="4" | Zelfmetingen
| rowspan="2" | Meetwaarden vitale functies (PULL)
| Raadplegen meetwaarden vitale functies
| PGO
| MM-1.0.0-MVR-FHIR
| R1.0
| 3
|-
| Beschikbaar stellen meetwaarden vitale functies
| XIS
| MM-1.0.0-MVB-FHIR
| R1.0
| 3
|-
| rowspan="2" | Zelfmetingen vitale functies (PUSH)
| Sturen zelfmetingen van vitale functies
| PGO
| MM-1.0.0-ZVS-FHIR
| R1.1
| 3
|-
| Ontvangen zelfmetingen vitale functies
| XIS
| MM-1.0.0-ZVO-FHIR
| R1.1
| 3
|-
| rowspan="6" | [[Bestand:PDF-A_icoon_zonder_tekst.png|link=|PDF/A|50px]]
| rowspan="6" | PDF/A
| rowspan="2" | PDFA metadata lijst (PULL)
| Raadplegen PDF/A metadata lijst
| PGO
| MM-1.0.0-PDR-FHIR
| R1.0
| 3
|-
| Beschikbaar stellen PDF/A metadata lijst
| XIS
| MM-1.0.0-PDB-FHIR
| R1.0
| 3
|-
| rowspan="2" | PDFA (PULL)
| Raadplegen PDF/A
| PGO
| MM-1.0.0-PDR-FHIR
| R1.0
| 3
|-
| Beschikbaar stellen PDF/A
| XIS
| MM-1.0.0-PDB-FHIR
| R1.0
| 3
|-
| rowspan="2" | PDFA (PUSH)
| Sturen PDF/A
| PGO
| MM-1.0.0-PDS-FHIR
| R1.1
| 3
|-
| Ontvangen PDF/A
| XIS
| MM-1.0.0-PDO-FHIR
| R1.1
| 3
|-
| rowspan="2" | [[Bestand:Allergie.png|link=https://www.nictiz.nl/standaardisatie/informatiestandaarden/medicatieveiligheid| Medicatieveiligheid|50px]]
| rowspan="2" | Medicatieveiligheid
| rowspan="2" | AllergieIntolerantie gegevens (PULL)
| Raadplegen AllergieIntolerantie gegevens
| PGO
| MP-6.12.6-AIR-FHIR
| R1.0
| 3
|-
| Beschikbaar stellen AllergieIntolerantie gegevens
| XIS
| MP-6.12.6-AIB-FHIR
| R1.0
| 3
|-
| rowspan="12" | [[Bestand:EAfspraak_icoon_zonder_tekst.png|link=MedMij:V2018.04_OntwerpeAfspraak|50px]]
| rowspan="12" | eAfspraak
| rowspan="2" | Afspraken (PULL)
| Raadplegen afspraak
| PGO
| EA-1.0.0-AFR-FHIR
| R1.0
| 3
|-
| Beschikbaar stellen afspraak
| XIS
| EA-1.0.0-AFB-FHIR
| R1.0
| 3
|-
| rowspan="2" | AfspraakSlots (PULL)
| Raadplegen afspraak slots
| PGO
| EA-1.0.0-ASR-FHIR
| R1.1
| 1
|-
| Beschikbaar stellen afspraak slots
| XIS
| EA-1.0.0-ASB-FHIR
| R1.1
| 1
|-
| rowspan="2" | AfspraakType (PULL)
| Raadplegen afspraak typen
| PGO
| EA-1.0.0-ATR-FHIR
| R1.1
| 1
|-
| Beschikbaar stellen afspraak typen
| XIS
| EA-1.0.0-ATB-FHIR
| R1.1
| 1
|-
| rowspan="2" | AfspraakVerzoek (PUSH)
| Sturen afspraakverzoek
| PGO
| EA-1.0.0-AVS-FHIR
| R1.1
| 1
|-
| Ontvangen afspraakverzoek
| XIS
| EA-1.0.0-AVO-FHIR
| R1.1
| 1
|-
| rowspan="2" | AfspraakAnnulering (PUSH)
| Sturen afspraak annulering
| PGO
| EA-1.0.0-AAS-FHIR
| R1.1
| 1
|-
| Ontvangen afspraak annulering
| XIS
| EA-1.0.0-AAO-FHIR
| R1.1
| 1
|-
| rowspan="2" | AfspraakWijziging (PUSH)
| Sturen afspraak wijzigingsverzoek
| PGO
| EA-1.0.0-AWS-FHIR
| R1.1
| 1
|-
| Ontvangen afspraak wijzigingsverzoek
| XIS
| EA-1.0.0-AWO-FHIR
| R1.1
| 1
|-
| rowspan="2" | [[Bestand:Huisartsgegevens.png|link=MedMij:V2018.04_OntwerpHuisartsgegevens|Huisartsgegevens|50px]]
| rowspan="2" | Huisartsgegevens
| rowspan="2" | Huisartsgegevens (PULL)
| Raadplegen Huisartsgegevens
| PGO
| MM-1.0.0-HGR-FHIR
| R1.1
| 1
|-
| Beschikbaar stellen Huisartsgegevens
| XIS
| MM-1.0.0-HGB-FHIR
| R1.1
| 1
|}

=Release Notes=

{| class="wikitable"
! Versie !! Datum !! Omschrijving
|-
| [[MedMij:V2018.04_Ontwerpen|2018.04]] || 2018-05-07 || eAfspraak fase 2
|-
| [[MedMij:V2018.03_Ontwerpen|2018.03]] || 2018-05-07 || BgZ 2017 en Huisartsgegevens
|-
| [[MedMij:V2018.02_Ontwerpen|2018.02]] || 2018-03-29 || BgZ 2017 voor openbare consultatie
|-
| [[MedMij:V2018.01_Ontwerpen|2018.01]] || 2018-02-21 || Huisartsgegevens voor openbare consultatie
|-
| [[MedMij:V2017.04_Ontwerpen|2017.04]] || 2017-12-18 || Medicatie, Laboratoriumresultaten, Allergie/intolerantie, Zelfmetingen
|-
| [[MedMij:V2017.03_Ontwerpen|2017.03]] || 2017-11-07 || PDF/A
|-
| [[MedMij:V2017.02_Ontwerpen|2017.02]] || 2017-10-11 || eAfspraak
|-
| [[MedMij:V2017.01_Ontwerpen|2017.01]] || 2017-10-02 || BgZ 2015
|}

MedMij:V2018.04 OntwerpHuisartsgegevens

2018-08-30T14:03:56Z

Marten Smits:

{{#customtitle:Use Cases Huisartsgegevens}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.04_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.04_FHIR GP Data|Technisch]]
desc none
</imagemap>

=Inleiding=
De basis voor de inhoud van dit ontwerp is de "[[#richtlijn-huisarts-patient|Richtlijn online inzage in het H-EPD door patiënt]]". Op basis van deze richtlijn wordt de patiënt in staat gesteld een samenvatting van zijn huisartsdossier online op te vragen.

==Use case: Raadplegen Huisartsgegevens door patiënt==
===Doel en relevantie===
Online inzage door de patiënt in het elektronisch patiëntendossier bij de huisarts (H-EPD) heeft als doel om de zorg beter te maken. De patiënt krijgt door online inzage meer overzicht en is beter geïnformeerd. Hierdoor heeft de patiënt meer begrip van en regie over de eigen gezondheid en het stimuleert zelfzorg. Ook kan het de kwaliteit van het dossier helpen verhogen.

===Domein===
Huisartsgegevens in het domein van zorgaanbieders en patiënten.

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van een huisartsgegevens vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De gegevens zoals deze door de huisarts worden aangeboden voor online inzage aan de patiënt bestaan uit 10 secties (zie bijlage 1 van de richtlijn). Een aantal daarvan overlappen met de [[MedMij:V2018.04 OntwerpBGZ|Basisgegevensset Zorg]] (BgZ) en een aantal daarvan zijn uniek voor het huisartsdossier. De richtlijn baseert zich op het [[#his-referentiemodel-2016|HIS referentiemodel]]. Die richtlijn heeft geen relatie met de [http://www.zibs.nl Zorginformatiebouwstenen] (zibs). Voor een aantal secties is deze relatie wel te leggen en voor een aantal ook niet (goed). De discrepanties zullen in de toekomst, in het Nictiz/NHG project "Huisartsoverdrachten", nog verder onderzocht en geslecht worden. Dit ontwerp Huisartsgegevens loopt daarop vooruit, omdat alle FHIR-profielen zich baseren op de zibs. Dit ontwerp en de technische uitwerking zal worden bijgewerkt, zodra de geharmoniseerde zorginformatiebouwstenen beschikbaar zijn. Dit zal naar verwachting niet vóór 2019 plaatsvinden.

In de MedMij FHIR implementatiegids staat de technische representatie van de betreffende zibs in zogenaamde FHIR profielen. In onderstaand overzicht is te zien welk FHIR profiel bij welke zib hoort.

{| class="wikitable collapsible collapsed" cellpadding="10" width="80%"
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="4" | Bijlage 1 Richtlijn Online inzage in het H-EPD door patiënt
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="2" | (Voorlopige) mapping naar zibs
|-
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| #
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| Onderdelen uit het Huisarts‑EPD
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| Beschrijving
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| Uitleg met voorbeelden
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| Zorginformatiebouwsteen
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| Opmerking
|-
| style="background-color: white;vertical-align:top;"| 1
| style="background-color: white;vertical-align:top;"|Huisarts/Huisartsenpraktijk
| style="background-color: white;vertical-align:top;"|De huisarts en/of de huisartsenpraktijk waar de gegevens van afkomstig zijn.
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"| [https://zibs.nl/wiki/Zorgverlener-v3.1(2017NL) Zorgverlener v3.1 (2017)] [https://zibs.nl/wiki/Zorgaanbieder-v3.1(2017NL) Zorgaanbieder v3.1 (2017)]
| style="background-color: white;vertical-align:top;"|
|-
| style="vertical-align:top;"| 2
| style="vertical-align:top;"|Patiënt
| style="vertical-align:top;"|De patiëntgegevens van de patiënt waarvoor de samenvatting is.
| style="vertical-align:top;"|
| style="vertical-align:top;"| [https://zibs.nl/wiki/Patient-v3.1(2017NL) Patient v3.1 (2017)]
| style="vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"| 3
| style="background-color: white;vertical-align:top;"|Episodes
| style="background-color: white;vertical-align:top;"|Een gezondheidsprobleem zoals een klacht of een aandoening, waarvan de aard in de loop der tijd kan veranderen door voortschrijdend inzicht of door het beloop van de aandoening.
| style="background-color: white;vertical-align:top;"|Ziekten, aandoeningen, klachten en symptomen. Bijvoorbeeld: blaasontsteking of droge hoest.
| style="background-color: white;" rowspan="3"| [https://zibs.nl/wiki/OverdrachtConcern-v1.2(2015NL) OverdrachtConcern v1.2 (2015)] [https://zibs.nl/wiki/Alert-v3.1(2017EN) Alert v3.1 (2017)]
| style="background-color: white;" rowspan="3"| Na 2015 is nog een versie 3.0 in 2016 uitgebracht die alleen in versie, niet in inhoud veranderd is. De versie van 2017 echter heeft expliciet gebruik voor episodes geschrapt.
|-
| style="vertical-align:top;"| 4
| style="vertical-align:top;"|Episodes met een attentievlag
| style="vertical-align:top;"|Episodes kunnen een attentievlag hebben om extra aandacht voor de episode te vragen. De attentievlag kan aanwezig blijven als een episode afgesloten wordt/is, wanneer de gebruiker het belangrijk vindt dit probleem in beeld te houden.
| style="vertical-align:top;"|Belangrijke ziekten, aandoeningen, klachten en symptomen. Bijvoorbeeld: reuma, suikerziekte, kanker, erfelijke ziekten.
|-
| style="background-color: white;vertical-align:top;"| 5
| style="background-color: white;vertical-align:top;"|Open en gesloten episodes
| style="background-color: white;vertical-align:top;"|Episodes kunnen open (actueel) of gesloten (niet langer actueel) zijn.
| style="background-color: white;vertical-align:top;"|Open/actueel: ziekten, aandoeningen, klachten en symptomen waarvoor nog zorg wordt verleend. Gesloten/niet actueel: ziekten, aandoeningen, klachten en symptomen waarvoor in het verleden zorg is verleend.
|-
| style="vertical-align:top;"| 6
| style="vertical-align:top;"|Behandeling
| style="vertical-align:top;"|Handeling aan de patiënt, die invloed heeft op de gezondheidstoestand van de patiënt.
| style="vertical-align:top;"|Operaties en (zware) behandelingen zoals bestraling of chemotherapie.
| style="vertical-align:top;"| ''[https://zibs.nl/wiki/Verrichting-v4.0(2017NL) Verrichting v4.0 (2017)]''
| style="vertical-align:top;"| Zib ondersteunt alleen de DHD Verrichtingenthesaurus waarmee het huisartssysteem niet werkt.
|-
| style="background-color: white;vertical-align:top;"| 7
| style="background-color: white;vertical-align:top;"| Profylaxe en voorzorg
| style="background-color: white;vertical-align:top;"| In Profylaxe en voorzorg worden voorzorgsmaatregelen vastgelegd die nodig zijn bij of vanwege bepaalde medische aandoeningen.
| style="background-color: white;vertical-align:top;"| Bijvoorbeeld voorzorgen bij ooit doorgemaakte endocarditis (ontsteking van de binnenbekleding van het hart en de hartkleppen) of na een miltverwijdering.
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"| Er is in principe slechts een type uit NHG tabel 56
|-
| style="vertical-align:top;"| 8
| style="vertical-align:top;"| Actuele medicatie
| style="vertical-align:top;"| Medicatie-afspraak Het voorstel van een voorschrijver tot gebruik van medicatie waarmee de patiënt akkoord is. De afspraak kan zowel starten, herhalen, wijzigen als stoppen van medicatie betreffen.
| style="vertical-align:top;"| '''De actuele medicatie''' is het overzicht van de medicatieafspraken. Het is de lijst van geneesmiddelen die de patiënt nu gebruikt.
| style="vertical-align:top;"| [https://zibs.nl/wiki/Medicatieafspraak-v1.0(2017NL) Medicatieafspraak v1.0 (2017)]
| style="vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"| 9
| style="background-color: white;vertical-align:top;"| Medicatie-overgevoeligheid
| style="background-color: white;vertical-align:top;"| Een medicatie-overgevoeligheid beschrijft een overgevoeligheid van een patiënt voor een geneesmiddel, een stof of een geneesmiddelengroep, waarmee rekening gehouden moet worden bij het voorschrijven van medicatie.
| style="background-color: white;vertical-align:top;"| Lijst van geneesmiddelen waarop in het verleden een overgevoeligheid of levensbedreigende allergische reactie is opgetreden. Bijvoorbeeld: allergie voor aspirine.
| style="background-color: white;vertical-align:top;"| [https://zibs.nl/wiki/AllergieIntolerantie-v3.1(2017NL) AllergieIntolerantie v3.1 (2017)]
| style="background-color: white;vertical-align:top;"|
|-
| style="vertical-align:top;"| 10
| style="vertical-align:top;"|Correspondentie
| style="vertical-align:top;"|Inkomend: Een binnengekomen brief betreffende een patiënt, die als zodanig is vastgelegd in het medisch dossier van de patiënt. Uitgaand: Een brief die opgesteld is door een praktijkmedewerker en naar een externe zorgverlener verstuurd is.
| style="vertical-align:top;"|Inkomende = brieven uit het ziekenhuis, polikliniek, zorginstelling. Uitgaande = verwijsbrieven.
| style="vertical-align:top;"| ''[https://zibs.nl/wiki/TekstUitslag-v4.0(2017NL) TekstUitslag v4.0 (2017)]''
| style="vertical-align:top;"| Correspondentie kan een binair bestand zijn zoals PDF/A, typen in de zib zijn niet toereikend voor alle typen correspondentie
|-
| style="background-color: white;vertical-align:top;"| 11
| style="background-color: white;vertical-align:top;"|Resultaten van bepalingen – ''laatste veertien maanden''
| style="background-color: white;vertical-align:top;"|Een bepaling is een objectiveerbare diagnostische verrichting. Het resultaat is de (uitkomst) van een bepaling.
| style="background-color: white;vertical-align:top;"|Uitslagen van fysieke metingen, zoals bloeddruk, gewicht en laboratoriumtesten, zoals ijzergehalte in het bloed.
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/LaboratoriumUitslag-v4.0(2017NL) LaboratoriumUitslag v4.0 (2017)] 
[https://zibs.nl/wiki/Bloeddruk-v3.1(2017NL) Bloeddruk v3.1 (2017)] 
[https://zibs.nl/wiki/Lichaamsgewicht-v3.1(2017NL) Lichaamsgewicht v3.1 (2017)] 
[https://zibs.nl/wiki/Lichaamslengte-v3.1(2017NL) Lichaamslengte v3.1 (2017)] 
[https://zibs.nl/wiki/Lichaamstemperatuur-v3.1(2017NL) Lichaamstemperatuur v3.1 (2017)] 
[https://zibs.nl/wiki/AlgemeneMeting-v3.0(2017NL) AlgemeneMeting v3.0 (2017)] 
[https://zibs.nl/wiki/Hartfrequentie-v3.1(2017NL) Hartfrequentie v3.1 (2017)] 
[https://zibs.nl/wiki/O2Saturatie-v3.1(2017NL) O2Saturatie v3.1(2017)] 
[https://zibs.nl/wiki/Polsfrequentie-v3.1(2017NL) Polsfrequentie v3.1(2017)]
| style="background-color: white;vertical-align:top;"|
|-
| style="vertical-align:top;"| 12
| style="vertical-align:top;"|E- en P-regels van de SOEP- structuur - ''vastgelegd na invoering van online inzage''
| style="vertical-align:top;"|Informatie uit een deelcontact dat in vrije tekst wordt geregistreerd volgens de SOEP-structuur. Het acroniem SOEP staat voor Subjectief, Objectief, Evaluatie en Plan.
| style="vertical-align:top;"|In de E(valuatie)-regel staat de conclusie van het consult. In de P(lan)-regel staan de afgesproken zaken en eventuele vervolgstappen.
| style="vertical-align:top;"| ''[https://zibs.nl/wiki/TekstUitslag-v4.0(2017NL) TekstUitslag v4.0 (2017)]''
| style="vertical-align:top;"| Journaalregeltype en ICPC-codering, extra t.o.v. in zib
|}

====Raadplegen huisartsgegevens ====
De vraag wordt gesteld aan de huisarts of huisartsenpraktijk. Er zijn geen verdere parameters bekend. Zie de [[#richtlijn-huisarts-patient|richtlijn]] voor de verdere context van de vraag naar de huisartsgegevens.

Dit betreft de filtermogelijkheden (parameters) in de vraag om huisartsgegevens.

====Beschikbaar stellen huisartsgegevens====
Zie voor de Informatie-elementen in huisartsgegevens de [[#richtlijn-huisarts-patient|richtlijn]].

Dit betreft de inhoud van de transactie met huisartsgegevens.

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" cellpadding="10" width="50%
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil huisartsgegevens raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt huisartsgegevens beschikbaar
|}
'''Bedrijfsrollen huisartsgegevens'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity_Diagram_-_Huisartspatientsamenvatting.jpg|Activiteitendiagram Raadplegen huisartsgegevens]]

'''Activiteitendiagram Raadplegen huisartsgegevens'''

===Procesbeschrijving===
===='Patient journey' - Roos Dalstra ====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u in de [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Roos_Dalstra_MedMij.pdf casus Roos Dalstra].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van de huisartsgegevens een rol speelt.

<blockquote></blockquote>

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het systeem van een zorgaanbieder (XIS) stelt huisartsgegevens beschikbaar aan het systeem van een patiënt (PGO).
Deze paragraaf vervolgt met een beschrijving van precondities, processtappen, en postcondities.
=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van huisartsgegevens tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

De patiënt wil de huisartsgegevens inzien en de zorgaanbieder stelt deze ook beschikbaar.
:Een patiënt kan steeds zelf het initiatief nemen om een huisartsgegevens op te halen, maar het is ook mogelijk dat een PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de beschrijving van deze use case geen verschil.

=====Processtappen=====
*Het systeem van de patiënt (PGO) vraagt om de beschikbare huisartsgegevens bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de huisartsgegevens op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om de huisartsgegevens in te zien.

=====Postconditie=====
De patiënt kan de huisartsgegevens inzien via de persoonlijke gezondheidsomgeving.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om de gegevens van zorgaanbieder naar patiënt.

Een PGO vervult de volgende systeemrol:
* HuisartsPatiëntsamenvattingRaadplegend Systeem [MM-1.0.0-HGR-FHIR].

Een XIS vervult in deze use case de volgende systeemrol:
* HuisartsPatiëntsamenvattingBeschikbaarstellend Systeem in FHIR [MM-1.0.0-HGB-FHIR]

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Huisartspatientsamenvatting_(Totaal).jpg|Componentendiagram]]

'''Componentendiagram'''

De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Link naar technische specificatie'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Huisartsgegevens (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen huisartsgegevens
|style="background-color: white;vertical-align:top;"|MM-1.0.0-HGR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2018.04_FHIR GP Data|Huisartsgegevens in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaar stellen huisartsgegevens
|style="background-color: white;vertical-align:top;"|MM-1.0.0-HGB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Huisartspatientsamenvatting.jpg|Use case diagram raadplegen Huisartsgegevens]]

'''Use case diagram

=Functionaliteit=
Er zijn geen aanwijzingen/eisen voor functionaliteit van de systemen.

=Verantwoordelijkheid voor informatie=
Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

=Infrastructuur=
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| Richtlijn Online inzage in het H-EPD door patiënt
| style="background-color: white;"|
| style="background-color: white;"| 2017
| style="background-color: white;"| https://www.nhg.org/themas/publicaties/richtlijn-online-inzage-het-h-epd-door-patient of de [https://www.nhg.org/sites/default/files/content/nhg_org/images/richtlijn_online_inzage_in_het_h-epd_door_patient_web_2017.pdf directe link (PDF)]
| style="background-color: white;"| NHG / Patiëntenfederatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| HIS referentiemodel Publieksversie (Utrecht 2016)
| style="background-color: white;"|
| style="background-color: white;"| 2016
| style="background-color: white;"| https://referentiemodel.nhg.org/inhoud/themas/publieksversie/published
| style="background-color: white;"| NHG
|}
'''Referenties

MedMij:V2018.04 OntwerpBeelden

2018-08-30T14:03:47Z

Marten Smits:

{{#customtitle:Use Cases uitwisselen van beelden met de Patient}}

[[Bestand:beeldenIcoon.png |link=|links |87px|beelden]]
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.04_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.04_FHIR_Images|Technisch]]
desc none
</imagemap>

=Inleiding=
Deze pagina beschrijft hoe een patiënt medische beeldinformatie kan raadplegen dan wel sturen met behulp van een persoonlijke gezondheidsomgeving (PGO). Met medische beeldinformatie ofwel beelden bedoelen we bijvoorbeeld röntgenfoto's, CT scans en echo's, maar ook video en audio. In het zorgaanbieder domein is DICOM de voornamelijkste gebruikte standaard voor de opslag en verwerking van beelden. DICOM is een internationale standaard en is ontwikkeld om de uitwisseling en bruikbaarheid van digitale beelden tussen verschillende systemen mogelijk te maken. Meer algemene informatie over de DICOM standaard is te vinden op de [https://www.nictiz.nl/standaarden/dicom/ Nictiz website].

Algemene informatie behorende bij deze use cases kan gevonden worden op deze [https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.04_Ontwerpen hoofd wikipagina].

==Scope==
Beelden spelen een belangrijke en groeiende rol binnen de gezondheidszorg. Beelden worden over vrijwel de gehele linie gebruikt. Hierdoor betreft dit functionele ontwerp een breed domein en zijn er keuzes gemaakt over de scope van de MedMij informatiestandaard. Als eerste prioriteit staat het raadplegen van DICOM beelden door de patient. Een tweede prioriteit is het delen van beelden met een zorgverlener door de patient.

=Raadplegen beelden door een PGO=
==IHE WIA==
MedMij gebruikt voor het raadplegen van beelden het Web-based Image Access (WIA) profiel van Intergrading the Healthcare Enterprise (IHE). Dit profiel definieert use cases voor het delen van DICOM beelden op basis van RESTful services. Het WIA profiel beschrijft hiervoor hoe de DICOM RESTful transacties QIDO-RS en WADO-RS gebruikt dienen te worden. Een PGO kan met de QIDO-RS transactie DICOM studie metadata ophalen en vervolgens met de WADO-RS transactie de betreffende DICOM bestanden raadplegen.

De volgende vier use cases worden beschreven in het IHE WIA profiel:
* Raadplegen DICOM beelden
* Interactief raadplegen DICOM beelden
* Raadplegen DICOM beelden op basis van raadplegen verslag via IHE MHD
* Interactief raadplegen DICOM beelden in een IHE XDS-I omgeving

Het IHE WIA profiel kan hier gevonden worden: http://ihe.net/uploadedFiles/Documents/Radiology/IHE_RAD_Suppl_WIA.pdf

==IHE MHD==
Één van de use case beschrijft hoe eerst een verslag of document met beelden wordt geraadpleegd door middel van het IHE profiel Mobile Health Documents (MHD). De metagegevens van het document bevat de gegevens waarmee de DICOM beelden door middel van de QIDO-RS en WADO-RS transactie geraadpleegd kunnen worden. De MedMij use case PDF/A, gebaseerd op het IHE Mobile Health Documents, kan in deze use case gebruikt worden voor het raadplegen van verslagen, zoals bijvoorbeeld een radiologie verslag, waarna met het WIA profiel de betreffende beelden geraadpleegd kunnen worden.

De MedMij PDF/A use case: https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.04_OntwerpPDFA

Het IHE MHD profiel: http://www.ihe.net/uploadedFiles/Documents/ITI/IHE_ITI_Suppl_MHD.pdf

==WIA actoren in relatie tot MedMij==

{| class="wikitable"
! style="font-weight:bold;" | IHE WIA actoren
! style="font-weight:bold;" | Transacties
! style="font-weight:bold;" | MedMij Systeemrol
! style="font-weight:bold;" | MedMij Systeem
! style="font-weight:bold;" | MedMij Bedrijfsrol
! style="font-weight:bold;" | Technisch
|-
| rowspan="2" | Imaging Document Consumer
| WADO-RS Retrieve
| rowspan="2" | WIA-1.1.0-BER-FHIR
| rowspan="2" | PGO
| rowspan="2" | Patient
| rowspan="4" | Link naar technische pagina
|-
| QIDO-RS Query
|-
| Imaging Document Responder
| QIDO-RS Query
| rowspan="2" | WIA-1.1.0-BEB-FHIR
| rowspan="2" | XIS
| rowspan="2" | Zorgaanbieder
|-
| Imaging Document Source
| WADO-RS Retrieve
|}

MedMij:V2018.04 OntwerpPDFA

2018-08-30T14:03:39Z

Marten Smits:

{{#customtitle:Use Cases PDF/A}}

[[Bestand:PDF-A icoon.png |link=|links |87px|PDF/A]]
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.04_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.04_FHIR_PDFA|Technisch]]
desc none
</imagemap>

=Inleiding=
Deze pagina beschrijft use cases waarbij een patiënt medische gegevens in de vorm van een PDF/A kan raadplegen en versturen met behulp van een persoonlijke gezondheidsomgeving. MedMij heeft het [https://nl.wikipedia.org/wiki/PDF/A PDF/A] formaat gekozen als uitwisselingsformaat voor ongestructureerde gezondheidsgegevens. Algemene informatie betreffende deze use cases kan gevonden worden op deze [https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.04_Ontwerpen wiki pagina].

=Use Cases=
Deze sectie vervolgt met de volgende use cases:
* [[MedMij:V2018.04_OntwerpPDFA#Use_case:_Raadplegen_medische_gegevens_in_PDF.2FA_door_pati.C3.ABnt | Raadplegen medische gegevens in PDF/A]]
* [[MedMij:V2018.04_OntwerpPDFA#Use_case:_Sturen_medische_gegevens_in_PDF.2FA_door_pati.C3.ABnt| Sturen medische gegevens in PDF/A]]
==Use case: Raadplegen medische gegevens in PDF/A door patiënt==
===Doel en relevantie===
Het voor patiënten mogelijk maken regie op hun eigen gezondheid te nemen door inzicht te geven in medische informatie die over henzelf gaan. Het is niet mogelijk om alle medische informatie direct gestructureerd te kunnen ontsluiten voor de patiënt. Dit ontwerp beschrijft het uitwisselen van ongestructureerde digitale informatie in een PDF/A format.

===Domein===
Documenten en ongestructureerde medische informatie in een PDF/A formaat in het domein van zorgaanbieders en patiënten.

===Context===
Het gaat om het elektronisch beschikbaar maken van medische gegevens in PDF/A formaat vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===

====Raadplegen medische gegevens in PDF/A====
Het raadplegen van een medische informatie gaat van een specifieke patiënt naar een specifieke organisatie in de zorg (bijvoorbeeld een zorgaanbieder).

Informatie elementen in de vraag om PDF/A documenten staan hieronder. Dit betreft de filtermogelijkheden (query paramaters) in de vraag om documentgegevens. Deze filtermogelijkheden zijn afgeleid van het [http://wiki.ihe.net/index.php/Mobile_access_to_Health_Documents_(MHD) IHE MHD profiel].

*patient
*periode (startdatum - einddatum)
*auteur
*type document
*categorie
*status
*setting (aanvullende details over waar de content is gemaakt / specialisme)
*medische handelingen (belangrijkste uitgevoerde medische handelingen)

====Beschikbaar stellen medische gegevens in PDF/A ====
De informatie-elementen voor het beschikbaar stellen van een PDF/A worden beschreven in het [http://wiki.ihe.net/index.php/Mobile_access_to_Health_Documents_(MHD) IHE MHD profiel]. Dit betreft de inhoud van de transactie waarbij het om de volgende [http://hl7.org/fhir/STU3 HL7 FHIR STU3] informatie modellen en [https://zibs.nl/wiki/ZIB_Hoofdpagina Zorginformatiebouwstenen] gaat:

*HL7 FHIR
** [http://hl7.org/fhir/STU3/bundle.html Bundle]
** [http://hl7.org/fhir/STU3/documentmanifest.html DocumentManifest]
** [http://hl7.org/fhir/STU3/documentreference.html DocumentReference]
** [http://hl7.org/fhir/STU3/binary.html Binary]

*Zorginformatiebouwstenen
** [https://zibs.nl/wiki/Patient-v2.0.1(2015NL) Patient]
** [https://zibs.nl/wiki/Zorgverlener-v1.2.1(2015NL) Zorgverlener]

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil medische gegevens in PDF/A formaat raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt medische gegevens in PDF/A formaat beschikbaar
|}
'''Bedrijfsrollen afspraak inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - PDFA raadplegen.png|Activiteitendiagram PFD/A raadplegen]]

'''Activiteitendiagram PDF/A raadplegen'''

===Procesbeschrijving===
===='Patient journey' - Roos Dalstra ====
Het verhaal van de 'patient journey' van Roos vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Roos_Dalstra_MedMij.pdf hier]. Hieronder een voor Roos relevante situatie waarbij het raadplegen van een PDF/A document rol speelt.

<blockquote> Na het ontslag komt de informatie over de opnameperiode vanuit het ziekenhuis beschikbaar in de PGO, zodat zij een goed beeld heeft van haar opname en haar medicatie. Dit kan zij ook delen met haar naasten.
</blockquote>

Roos zou in haar PGO bijvoorbeeld de ontslagbrief van haar opname kunnen opvragen.

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het systeem van een zorgaanbieder (XIS) stelt de PDF/A beschikbaar aan het systeem van een patiënt (PGO).
Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.
=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van medische gegevens in PDF/A tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

De patiënt wil zijn medische gegevens inzien en de zorgaanbieder stelt dit ook beschikbaar.
:Een patiënt kan steeds zelf het initiatief nemen om zijn medische gegevens op te halen, maar het is ook mogelijk dat een PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de beschrijving van deze use case geen verschil.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare medische gegevens bij een XIS aan de hand van een zoekopdracht.
*Het systeem van de zorgaanbieder (XIS) levert een lijst met metadata over de gevonden PDF/A documenten op voor de patiënt.
*De Patiënt gebruikt de persoonlijke gezondheidsomgeving om de gewenste PDF/A te raadplegen of te downloaden.
*Het systeem van de zorgaanbieder (XIS) levert de PDF/A op voor de patiënt.

=====Post conditie=====
De patiënt heeft zijn medische gegevens geraadpleegd via de persoonlijke gezondheidsomgeving.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen hebben meerdere systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk.
De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| PDFARaadplegend
| style="background-color: white;"| MM-1.0.0-PDR-FHIR
| style="background-color: white;"| Raadplegen PDF/A document bij zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| PDFABeschikbaarstellend
| style="background-color: white;"| MM-1.0.0-PDB-FHIR
| style="background-color: white;"| Beschikbaar stellen PDF/A document bij patient
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_PDFA_raadplegen_(Totaal)_v2.0.png|Componenten diagram PDF/A raadplegen]]

'''Componenten diagram PDFA raadplegen'''

=== Transacties, transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|PDFA metadata lijst (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen PDF/A metadata lijst
|style="background-color: white;vertical-align:top;"|MM-1.0.0-PDR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="4"|[[MedMij:V2018.04_FHIR_PDFA|PDF/A in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen PDF/A metadata lijst
|style="background-color: white;vertical-align:top;"|MM-1.0.0-PDB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|PDFA (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen PDF/A
|style="background-color: white;vertical-align:top;"|MM-1.0.0-PDR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen PDF/A
|style="background-color: white;vertical-align:top;"|MM-1.0.0-PDB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_PDFA_raadplegen_V2.0.png|Use case diagram PDF/A raadplegen]]

'''Use case diagram PDF.A 

==Use case: Sturen medische gegevens in PDF/A door patiënt==
===Doel en relevantie===
Het voor patiënten mogelijk maken regie op hun eigen gezondheid te nemen door medische informatie te delen met zorgverleners. Het is niet mogelijk om alle medische informatie direct te kunnen gestructureerd te kunnen versturen. Dit ontwerp beschrijft het uitwisselen van ongestructureerde digitale informatie in PDF/A formaat.

===Domein===
Documenten en ongestructureerde medische informatie in een PDF/A format in het domein van zorgaanbieders en patiënten.

===Context===
Het gaat om het elektronisch beschikbaar maken van afspraken vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===

====Sturen van Medische gegevens in PDF/A====
Het sturen van een medische informatie gaat van een specifieke patiënt naar een specifieke organisatie in de zorg (bijvoorbeeld een zorgaanbieder).

De informatie-elementen voor het sturen van een PDF/A worden beschreven in het [http://wiki.ihe.net/index.php/Mobile_access_to_Health_Documents_(MHD) IHE MHD profiel]. Dit betreft de inhoud van de transactie waarbij het om de volgende [http://hl7.org/fhir/STU3 HL7 FHIR STU3] informatie modellen en [https://zibs.nl/wiki/ZIB_Hoofdpagina Zorginformatiebouwstenen] gaat:

*HL7 FHIR
** [http://hl7.org/fhir/STU3/bundle.html Bundle]
** [http://hl7.org/fhir/STU3/documentmanifest.html DocumentManifest]
** [http://hl7.org/fhir/STU3/documentreference.html DocumentReference]
** [http://hl7.org/fhir/STU3/binary.html Binary]

*Zorginformatiebouwstenen
** [https://zibs.nl/wiki/Patient-v2.0.1(2015NL) Patient]
** [https://zibs.nl/wiki/Zorgverlener-v1.2.1(2015NL) Zorgverlener]

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil medische gegevens in PDF/A formaat sturen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Ontvangt medische gegevens in PDF/A formaat
|}
'''Bedrijfsrollen afspraak inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Sturen sturen.png|Activiteitendiagram PFD/A sturen]]

'''Activiteitendiagram PDF/A sturen'''

===Procesbeschrijving===
===='Patient journey' - Roos Dalstra ====
Het verhaal van de 'patient journey' van Roos vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Roos_Dalstra_MedMij.pdf hier].

Hieronder een voor Roos relevante situatie waarbij het sturen van een PDF/A document rol kan spelen.
<blockquote>De internist in dienst die nacht wil graag weten welke medicatie Roos gebruikt. Aangezien Roos alles netjes heeft bijgehouden in haar persoonlijke
gezondheidsomgeving kan zij het ziekenhuis haar medicatiegegevens laten zien en laten uploaden naar het ziekenhuisinformatiesysteem. Hierdoor heeft de internist
een snel en accuraat overzicht van de huidige medicatie van Roos. </blockquote>

Wanneer een XIS niet in staat is om het medicatieoverzicht gestructureerd te ontvangen, zou het PGO het medicatieoverzicht in een PDF/A kunnen versturen. Zo heeft de arts wel gelijk de beschikking over het medicatieoverzicht.

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het systeem van een patiënt (PGO) stuurt de PDF/A naar het systeem van een zorgverlener (XIS).
Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.
=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van medische gegevens in PDF/A tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

De patiënt wil zijn medische gegevens inzien en de zorgaanbieder stelt dit ook beschikbaar.
:Een patiënt kan steeds zelf het initiatief nemen om zijn medische gegevens op te halen, maar het is ook mogelijk dat een PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de beschrijving van deze use case geen verschil.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) stuurt medische gegevens in PDF/A formaat naar een XIS.
*Het systeem van de zorgaanbieder (XIS) ontvangt een PDF/A van de patiënt.

=====Post conditie=====
De patiënt heeft zijn medische gegevens in PDF/A formaat verstuurd via de persoonlijke gezondheidsomgeving.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om afspraken van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| PDFASturend
| style="background-color: white;"| MM-1.0.0-PDS-FHIR
| style="background-color: white;"| Sturen PDF/A document naar zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| PDFAOntvangend
| style="background-color: white;"| MM-1.0.0-PDO-FHIR
| style="background-color: white;"| Ontvangen PDF/A document van de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - PDFA sturen (Totaal).png |Componenten diagram PDFA sturen]]

'''Componenten diagram PDF/A Sturen'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|PDFA (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen PDF/A
|style="background-color: white;vertical-align:top;"|MM-1.0.0-PDS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2018.04_FHIR_PDFA|PDF/A in FHIR]]

|-
|style="background-color: white;vertical-align:top;"|Ontvangen PDF/A
|style="background-color: white;vertical-align:top;"|MM-1.0.0-PDO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - PDFA sturen.png|Use case diagram PFD/A sturen]]

'''Use case diagram PDF/A sturen

=Functionaliteit=
Er zijn geen aanwijzingen/eisen voor functionaliteit van de systemen.

=Verantwoordelijkheid voor informatie=
Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

=Infrastructuur=
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| AUTEUR(S)
| style="background-color: white;"| TITEL
| style="background-color: white;"| VERSIE
| style="background-color: white;"| DATUM
| style="background-color: white;"| BRON
| style="background-color: white;"| ORGANISATIE
|}
'''Referenties

MedMij:V2018.04 OntwerpZelfmetingen

2018-08-30T14:03:29Z

Marten Smits:

{{#customtitle:Use cases vitale functies en zelfmetingen }}

[[Bestand:Self-Measuements_zonder_tekst.png |link=|links |85px|Zelfmetingen]]
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.04_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.04_FHIR_VitalSigns|Technisch]]
desc none
</imagemap>

=Inleiding=
Deze pagina beschrijft use cases voor de patiënt in relatie tot zelfmetingen van vitale functies die een patiënt kan verzamelen en delen door middel van een PGO. De vitale functies van de mens zijn de lichaamsfuncties die de persoon vitaal of ook wel in leven houden, voorbeelden zijn ademhaling en circulatie (hartslag en bloeddruk).

Momenteel bestaat er geen standaard voor zelfmeet gegevens van de vitale functies. Het doel van deze pagina is om verschillende uitwisseling scenario's van zelfmeet gegevens met de patiënt te beschrijven voor gebruik in MedMij.

Zoals [[MedMij:V2018.04_Ontwerpen|op deze pagina]] aangegeven, gebruikt MedMij zorginformatiebouwstenen (ZIB's) als leidraad voor de inhoud van informatie uitwisseling. Voor uitwisseling van zelfmeet gegevens gaat het om de volgende ZIB's:

*Patiënt
*Ademhaling
*Bloeddruk
*Hartfrequentie
*Lichaamsgewicht
*Lichaamslengte
*Lichaamstemperatuur
*O2Saturatie
*Pijnscore
*Polsfrequentie

=Use Cases=
==Use case: Raadplegen metingen betreffende de vitale functies door patiënt==
===Doel en relevantie===
Het voor patiënten mogelijk maken regie op hun eigen gezondheid te nemen door inzicht te geven in de vitale functie meetwaarden die over henzelf gaan.
===Domein===
Metingen betreffende vitale functies in het domein van zorgaanbieders en patiënten.

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van de meetwaarden van vitale functies vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn.

====Raadplegen meetwaarden ====
Informatie elementen in de vraag om meetwaarden van vitale functies.

* Patient identificatienummer
* Periode (startdatum - einddatum)
* Type (soort meetwaarden, bijvoorbeeld bloeddruk)

Dit betreft de filtermogelijkheden (query paramaters) in de vraag om meetwaarden van de vitale functies.

====Beschikbaar stellen meetwaarden meetwaarden====
Informatie elementen in meetwaarden van vitale functies staan hieronder. Het betreffen de Zorginformatiebouwstenen die te vinden zijn op https://zibs.nl/wiki/ZIB_Hoofdpagina.

*Patiënt
*Ademhaling
*Bloeddruk
*Hartfrequentie
*Lichaamsgewicht
*Lichaamslengte
*Lichaamstemperatuur
*O2Saturatie
*Pijnscore
*Polsfrequentie

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil meetwaarden van vitale functies raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt meetwaarden van vitale functies beschikbaar
|}
'''Bedrijfsrollen Medicatieoverzicht'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity_Diagram_-_MVF_raadplegen.jpg|Activiteitendiagram Raadplegen Meetwaarden vitale functies]]

'''Activiteitendiagram Raadplegen meetwaarden vitale functies'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas van Beek vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier]. Hieronder een voor Thomas relevante situatie waarbij het raadplegen van meetwaarden betreffende de vitale functie een rol speelt.

<blockquote>Voordat Thomas zijn consult bij de internist heeft om de resultaten door te spreken worden er een aantal andere waarden getest. Zijn gewicht en zijn bloeddruk worden opgemeten. De laboratoriumwaarden zijn al bekend voordat de internist ze aan Thomas mee kan delen. Alhoewel Thomas zoals gezegd zo min mogelijk met zijn ziekte bezig wil zijn, vindt hij de jaarlijkse controle heel belangrijk. Hij vindt het dan ook heel erg handig om de resultaten van de onderzoeken een dag van tevoren al in te zien in zijn PGO. Hij kan zich zo goed voorbereiden en zal niet meer verrast zijn over de resultaten als zijn internist deze voorlegt.</blockquote>

===='Patient journey' - Roos Dalstra ====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Roos_Dalstra_MedMij.pdf hier]. Hieronder een voor Roos relevante situatie waarbij het raadplegen van meetwaarden betreffende de vitale functie een rol speelt.

<blockquote>Na het ontslag komt de informatie over de opnameperiode vanuit het ziekenhuis beschikbaar in de PGO, zodat zij een goed beeld heeft van haar opname en haar medicatie. Dit kan zij ook delen met haar naasten</blockquote>

Roos kan na haar opname haar vitale waarden gemeten in ziekenhuis raadplegen. Zo beschikt zij over deze informatie die ze als referentiewaarden kan gebruiken.

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het systeem van een zorgaanbieder (XIS) stelt de gevraagde meetwaarden van de vitale functies beschikbaar aan het systeem van een patiënt (PGO).
Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.
=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van vitale functie meetwaarden tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

De patiënt wil de meetwaarden van de vitale functies inzien en de zorgaanbieder stelt dit ook beschikbaar.
:Een patiënt kan steeds zelf het initiatief nemen om de meetwaarden op te halen, maar het is ook mogelijk dat een PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de beschrijving van deze use case geen verschil.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) stuurt meetwaarden van de vitale functies naar een XIS.
*Het systeem van de zorgaanbieder (XIS) ontvangt meetwaarden van de vitale functies op voor de patiënt.
*De zorgverlener gebruikt zijn systeem om de meetwaarden van de vitale functies in te zien.

=====Post conditie=====
De patiënt heeft de meetwaarden vitale functies geraadpleegd via de persoonlijke gezondheidsomgeving.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt.

Een PGO vervult de volgende systeemrol:
* MeetwaardenVitaleFunctiesRaadplegend Systeem in FHIR [MM-1.0.0-MVR-FHIR].

Een XIS vervult in deze use case de volgende systeemrol:
* MeetwaardenVitaleFunctiesBeschikbaarstellend Systeem in FHIR [MM-1.0.0-MVB-FHIR]

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_MVF_raadplegen_(Totaal).jpg|Componenten diagram]]

'''Componenten diagram'''

De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Meetwaarden Vitale Functies(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen meetwaarden vitale functies
|style="background-color: white;vertical-align:top;"|MM-1.0.0-MVR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2018.04_FHIR_VitalSigns|Meetwaarden vitale functies in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen meetwaarden vitale functies
|style="background-color: white;vertical-align:top;"|MM-1.0.0-MVB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_MVF_raadplegen.jpg|Use case diagram raadplegen meetwaarden vitale functies]]

'''Use case diagram

==Use case: Sturen zelfmetingen van de vitale functies door patiënt==
===Doel en relevantie===
Het voor patiënten mogelijk maken regie op hun eigen gezondheid te nemen door het kunnen delen van hun zelfmeet gegevens met de zorgverlener.
===Domein===
Zelfmetingen betreffende vitale functies in het domein van zorgaanbieders en patiënten.

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van de zelfmeetwaarden van vitale functies vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS) .
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn
====Sturen zelfmetingen====
Informatie elementen in zelfmetingen betreffende vitale functies staan hieronder. Het betreffen Zorginformatiebouwstenen die te vinden zijn op https://zibs.nl/wiki/ZIB_Hoofdpagina.

*Patiënt
*Ademhaling
*Bloeddruk
*Hartfrequentie
*Lichaamsgewicht
*Lichaamslengte
*Lichaamstemperatuur
*O2Saturatie
*Pijnscore
*Polsfrequentie

====Ontvangen zelfmetingen====
Het ontvangende systeem stuurt een ontvangstbevestiging van de zelfmetingen.

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil zelfmetingen van vitale functies sturen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Ontvangt zelfmetingen van vitale functies
|}
'''Bedrijfsrollen Medicatieoverzicht'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity_Diagram_-_MVF_sturen.jpg|Activiteitendiagram Raadplegen Meetwaarden vitale functies]]

'''Activiteitendiagram sturen zelfmetingen vitale functies'''

===Procesbeschrijving===
===='Patient journey' - Roos Dalstra ====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Roos_Dalstra_MedMij.pdf hier].

Hieronder een voor Roos relevante situatie waarbij het sturen van zelfmetingen betreffende de vitale functie een rol speelt.

<blockquote>Sinds een aantal maanden maakt Roos gebruik van een online persoonlijke gezondheidsomgeving. Daarin houdt ze onder andere haar bloedglucosewaarden bij. Daarnaast moet ze zich dagelijks wegen in verband met haar hartfalen. Bij hartfalen is de pompfunctie van het hart verminderd. Het hart pompt niet genoeg bloed rond, hierdoor kun je vocht vasthouden. Om dit te monitoren weegt Roos zich dagelijks, en houdt ze haar gewicht bij in haar persoonlijke gezondheidsomgeving. Wanneer haar gewicht toeneemt, dan krijgt ze een signaal vanuit haar PGO, omdat dit zou kunnen duiden op het vasthouden van vocht. Doordat Roos de huisarts toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld iets in de medicatie wordt gewijzigd, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug. De huisarts kan op zijn beurt de gegevens die Roos heeft ingevoerd bekijken, bijvoorbeeld met een handige grafiek die haar bloedsuikers over de afgelopen periode laat zien</blockquote>

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het systeem van een patiënt (PGO) stelt zelfmetingen van de vitale functies beschikbaar aan het systeem van een zorgaanbieder (XIS).
Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.
=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van zelfmetingen van de vitale functies tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

De zorgaanbieder wil de zelfmetingen van de vitale functies inzien en de patiënt stelt dit ook beschikbaar.
:Een patiënt kan steeds zelf het initiatief nemen om de meetwaarden te sturen, maar het is ook mogelijk dat een PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de beschrijving van deze use case geen verschil.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) stuurt zelfmetingen van de vitale functies naar een XIS.
*Het systeem van de zorgaanbieder (XIS) ontvangt en verwerkt de zelfmetingen van de patiënt.
*De zorgaanbieder gebruikt de het XIS om de zelfmetingen van de vitale functies in te zien.

=====Post conditie=====
De patiënt heeft zelfmetingen gestuurd via de persoonlijke gezondheidsomgeving.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt.

Een PGO vervult de volgende systeemrol:
* ZelfmetingenVitaleFunctiesSturend Systeem in FHIR [MM-1.0.0-ZVS-FHIR].

Een XIS vervult in deze use case de volgende systeemrol:
* ZelfmetingenVitaleFunctiesOntvangend Systeem in FHIR [MM-1.0.0-ZVO-FHIR]

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_MVF_sturen_(Totaal).jpg|Componenten diagram]]

'''Componenten diagram'''

De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Zelfmetingen Vitale Functies(PUSH)
|style="background-color: white;vertical-align:top;"|Sturen zelfmetingen van vitale functies
|style="background-color: white;vertical-align:top;"|MM-1.0.0-ZVS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen zelfmetingen vitale functies
|style="background-color: white;vertical-align:top;"|MM-1.0.0-ZVO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_MVF_sturen.jpg|Use case diagram sturen zelfmetingen vitale functies]]

'''Use case diagram

=Functionaliteit=
Er zijn geen aanwijzingen/eisen voor functionaliteit van de systemen.

=Verantwoordelijkheid voor informatie=
Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

=Infrastructuur=
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| AUTEUR(S)
| style="background-color: white;"| TITEL
| style="background-color: white;"| VERSIE
| style="background-color: white;"| DATUM
| style="background-color: white;"| BRON
| style="background-color: white;"| ORGANISATIE
|}
'''Referenties

MedMij:V2018.04 OntwerpMedicatie

2018-08-30T14:02:49Z

Marten Smits:

{{#customtitle:Use Cases Medicatieproces|Use Cases Medicatieproces }}

[[Bestand:Medicatie_proces_Icoon.png |link=|links |85px|Medicatie Proces]]
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.04_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.04_FHIR_MedicationProcess|Technisch]]
desc none
</imagemap>

=Inleiding=
Deze pagina beschrijft use cases voor de patiënt in relatie tot de [https://www.nictiz.nl/Paginas/Medicatieproces.aspx informatiestandaard Medicatieproces] (MP). Deze use cases zijn gebaseerd op versie 9.x van deze standaard. Deze standaard beschrijft de uitwisseling met de patiënt nog niet expliciet. Het doel van deze pagina is om de verschillende uitwisselingsscenario's van medicatiegegevens met de patiënt toe te voegen.

Het is het streven van het MedMij-programma om deze beschrijvingen toe te voegen aan de bestaande standaard voor Medicatieproces.

Zoals [[MedMij:V1.0 Ontwerpen|op deze pagina]] aangegeven, gebruikt MedMij voor medicatiegegevens de bouwstenen uit de informatiestandaard Medicatieproces versie 9.x als leidraad voor de uitwisseling van informatie. Voor uitwisseling van medicatiegegevens gaat het om de volgende ZIB's:

*Patiënt;
*Zorgaanbieder;
*Zorgverlener;
*Medicatieafspraak;
*Verstrekkingsverzoek;
*Toedieningsafspraak;
*Verstrekking;
*Medicatiegebruik;
*Toediening.

=Use Cases=

==Use case: Raadplegen medicatieoverzicht door patiënt==
===Doel en relevantie===
Het voor patiënten mogelijk maken regie op hun eigen gezondheid te nemen door inzicht te geven in medicatiegegevens die over henzelf gaan.
===Domein===
Medicatiegegevens in het domein van zorgaanbieders en patiënten.

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van een medicatieoverzicht vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn gedefinieerd in ART-DECOR.
====Raadplegen medicatieoverzicht====
Informatie elementen in de vraag om medicatieoverzicht staan hieronder. Om deze informatie in een nieuwe tab te openen, klik [https://decor.nictiz.nl/medicatieproces/mp-html-20180426T140905/tr-2.16.840.1.113883.2.4.3.11.60.20.77.4.147-2016-11-08T103441.html hier].

Dit betreft de filtermogelijkheden (query paramaters) in de vraag om medicatieoverzicht.

<html>
<iframe width="100%" height="500" src=https://decor.nictiz.nl/medicatieproces/mp-html-20180426T140905/tr-2.16.840.1.113883.2.4.3.11.60.20.77.4.147-2016-11-08T103441.html frameborder="0" align="middle"></iframe>
</html>

====Beschikbaarstellen medicatieoverzicht====
Informatie elementen in medicatieoverzicht staan hieronder. Om deze informatie in een nieuwe tab te openen, klik [https://decor.nictiz.nl/medicatieproces/mp-html-20180426T140905/tr-2.16.840.1.113883.2.4.3.11.60.20.77.4.148-2016-11-08T103441.html hier].

Dit betreft de inhoud van het medicatieoverzicht.

<html>
<iframe width="100%" height="500" src=https://decor.nictiz.nl/medicatieproces/mp-html-20180426T140905/tr-2.16.840.1.113883.2.4.3.11.60.20.77.4.148-2016-11-08T103441.html frameborder="0" align="middle"></iframe>
</html>

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil medicatieoverzicht raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt medicatieoverzicht beschikbaar
|}
'''Bedrijfsrollen Medicatieoverzicht'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity_Diagram_-_Medicatieoverzicht.jpg|Activiteitendiagram Raadplegen Medicatieoverzicht]]

'''Activiteitendiagram Raadplegen Medicatieoverzicht'''

===Procesbeschrijving===
===='Patient journey' - Roos Dalstra ====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Roos_Dalstra_MedMij.pdf hier].

Hieronder een aantal voor Roos relevante situaties waarbij het raadplegen van een medicatieoverzicht een rol speelt.

<blockquote>De afgelopen weken is Roos aan het tobben met haar gezondheid, ze houdt vocht vast achter haar longen en voelt zich niet goed. Haar gewicht begint toe te nemen en haar bloedsuikers zijn niet meer stabiel, en ze maakt een afspraak bij haar huisarts, dokter Jacobs, op 16 juli. Deze verhoogt na onderzoek haar vochtafdrijvende medicatie iets, en geeft haar een nieuw schema waarin staat hoeveel insuline zij extra moet spuiten als de bloedglucosewaarden boven een bepaalde waarde komen. Deze medicatiewijzigingen worden ook zichtbaar in een vernieuwd medicatieoverzicht van huisartsenpraktijk Jacobs/Kroonen, die de situatie op 16 juli weergeeft. Dit medicatieoverzicht kan zij inzien in haar persoonlijke gezondheidsomgeving. Dit geeft haar grip op haar situatie, ze weet waar zij aan toe is.</blockquote>

<blockquote>Het gaat slechter met Roos en op een nacht wordt ze erg benauwd wakker, daarnaast is ze duizelig. Ondanks aanpassingen van de medicatie neemt de benauwdheid niet af, het wordt eerder erger. Joost, haar man, neemt daarom contact op met de huisartsenpost en na overleg wordt besloten dat Roos naar het ziekenhuis moet komen. Een ambulance haalt haar op. Diezelfde nacht nog wordt ze opgenomen op de afdeling cardiologie van het Epidaurus ziekenhuis. Roos blijft een aantal weken onder behandeling en langzaam verbetert haar situatie. Roos wordt op 23 augustus ontslagen uit het Epidaurus ziekenhuis. Haar medicatie is gedurende haar opname verschillende keren aangepast. Bij ontslag maakt de ziekenhuisapotheker een op dat moment actueel medicatieoverzicht voor Roos. Dit medicatieoverzicht maakt het apothekerssysteem beschikbaar voor de persoonlijke gezonheidsomgeving van Roos. Roos kan nu via haar PGO dit medicatieoverzicht van 23 augustus van het Epidaurus ziekenhuis bekijken. Dit geeft haar meer grip op haar gezondheidssituatie.</blockquote>

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het systeem van een zorgaanbieder (XIS) stelt een medicatieoverzicht beschikbaar aan het systeem van een patiënt (PGO).
Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.
=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van medicatieoverzichten tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

De patiënt wil het medicatieoverzicht inzien en de zorgaanbieder stelt dit ook beschikbaar.
:Een patiënt kan steeds zelf het initiatief nemen om een medicatieoverzicht op te halen, maar het is ook mogelijk dat een PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de beschrijving van deze use case geen verschil.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om een medicatieoverzicht bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert een medicatieoverzicht op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om het medicatieoverzicht in te zien.

=====Post conditie=====
De patiënt heeft het medicatieoverzicht geraadpleegd via de persoonlijke gezondheidsomgeving.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt.

Een XIS vervult in deze use case de volgende systeemrol:
* MedicatieoverzichtBeschikbaarstellend Systeem in FHIR [MP-9.0.6-MOB-FHIR].

Een PGO vervult de volgende systeemrol:
* MedicatieoverzichtRaadplegend Systeem in FHIR [MP-9.0.6-MOR-FHIR].

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Medicatieoverzicht (Totaal).jpg|Componenten diagram]]

'''Componenten diagram'''

De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Medicatieoverzicht (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen medicatieoverzicht
|style="background-color: white;vertical-align:top;"|MP-9.0.6-MOR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2018.04_FHIR_MedicationProcess|Medicatieoverzicht in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen medicatieoverzicht
|style="background-color: white;vertical-align:top;"|MP-9.0.6-MOB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Medicatiegegevens.jpg|Use case diagram raadplegen Medicatiegegevens]]

'''Use case diagram

==Use case: Raadplegen medicatiegegevens door patiënt==
===Doel en relevantie===
Het voor patiënten mogelijk maken regie op hun eigen gezondheid te nemen door inzicht te geven in medicatiegegevens die over henzelf gaan.
===Domein===
Medicatiegegevens in het domein van zorgaanbieders en patiënten.

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van een medicatiegegevens vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn gedefinieerd in de informatiestandaard voor Medicatieproces.
====Raadplegen medicatiegegevens====
Informatie elementen in de vraag om medicatiegegevens staan hieronder. Om deze informatie in een nieuwe tab te openen, klik [https://decor.nictiz.nl/medicatieproces/mp-html-20180426T140905/tr-2.16.840.1.113883.2.4.3.11.60.20.77.4.136-2016-07-12T133747.html hier].

Dit betreft de filtermogelijkheden (query paramaters) in de vraag om medicatiegegevens.

<html>
<iframe width="100%" height="500" src=https://decor.nictiz.nl/medicatieproces/mp-html-20180426T140905/tr-2.16.840.1.113883.2.4.3.11.60.20.77.4.136-2016-07-12T133747.html frameborder="0" align="middle"></iframe>
</html>

====Beschikbaarstellen medicatiegegevens====
Informatie elementen in medicatiegegevens staan hieronder. Om deze informatie in een nieuwe tab te openen, klik [https://decor.nictiz.nl/medicatieproces/mp-html-20180426T140905/tr-2.16.840.1.113883.2.4.3.11.60.20.77.4.102-2016-03-23T163243.html hier].

Dit betreft de inhoud van de transactie met medicatiegegevens.

<html>
<iframe width="100%" height="500" src=https://decor.nictiz.nl/medicatieproces/mp-html-20180426T140905/tr-2.16.840.1.113883.2.4.3.11.60.20.77.4.102-2016-03-23T163243.html frameborder="0" align="middle"></iframe>
</html>

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil medicatiegegevens raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt medicatiegegevens beschikbaar
|}
'''Bedrijfsrollen Medicatiegegevens'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity_Diagram_-_Medicatiegegevens.jpg|Activiteitendiagram Raadplegen Medicatiegegevens]]

'''Activiteitendiagram Raadplegen Medicatiegegevens'''

===Procesbeschrijving===
===='Patient journey' - Roos Dalstra ====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Roos_Dalstra_MedMij.pdf hier].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van een medicatiegegevens een rol speelt.

<blockquote>Roos heeft de afgelopen tijd in verband met haar hartfalen en diabetes diverse wijzigingen in haar medicatie gehad. Dit is soms gedaan door de specialist en soms door de huisarts. De apotheker paste dan daarna ook soms de doseerinstructies aan, omdat er een ander product geleverd moest worden dan voorgeschreven was. Eigenlijk is Roos het overzicht een beetje kwijtgeraakt. Gelukkig heeft haar PGO wel de mogelijkheid om bij al haar zorgverleners medicatiegegevens op te vragen. Haar PGO kan dit aan haar presenteren in een overzichtelijk geheel. Roos kan nu controleren of ze al haar medicatie inneemt conform de laatste afspraken die hierover zijn gemaakt. Dit is voor Roos heel geruststellend.</blockquote>

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het systeem van een zorgaanbieder (XIS) stelt een medicatiegegevens beschikbaar aan het systeem van een patiënt (PGO).
Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.
=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van medicatiegegevens tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

De patiënt wil medicatiegegevens inzien en de zorgaanbieder stelt dit ook beschikbaar.
:Een patiënt kan steeds zelf het initiatief nemen om een medicatiegegevens op te halen, maar het is ook mogelijk dat een PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de beschrijving van deze use case geen verschil.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare medicatiegegevens bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert medicatiegegevens op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om medicatiegegevens in te zien.

=====Post conditie=====
De patiënt kan medicatiegegevens inzien via de persoonlijke gezondheidsomgeving.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatiegegevensen van zorgaanbieder naar patiënt.

Een XIS vervult in deze use case de volgende systeemrol:
* Medicatiegegevenseschikbaarstellend Systeem in FHIR [MP-9.0.6-MGB-FHIR]

Een PGO vervult de volgende systeemrol:
* MedicatiegegevensRaadplegend Systeem [MP-9.0.6-MGR-FHIR].

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Medicatiegegevens (Totaal).jpg|Componenten diagram]]

'''Componenten diagram'''

De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Link naar technische specificatie'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Medicatiegegevens (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen medicatiegegevens
|style="background-color: white;vertical-align:top;"|MP-9.0.6-MGR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2018.04_FHIR_MedicationProcess|Medicatiegegevens in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen medicatiegegevens
|style="background-color: white;vertical-align:top;"|MP-9.0.6-MGB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Medicatieoverzicht.jpg|Use case diagram raadplegen Medicatieoverzicht]]

'''Use case diagram

=Functionaliteit=
Er zijn geen aanwijzingen/eisen voor functionaliteit van de systemen.

=Verantwoordelijkheid voor informatie=
Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

=Infrastructuur=
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| AUTEUR(S)
| style="background-color: white;"| TITEL
| style="background-color: white;"| VERSIE
| style="background-color: white;"| DATUM
| style="background-color: white;"| BRON
| style="background-color: white;"| ORGANISATIE
|}
'''Referenties

MedMij:V2018.04 OntwerpLabresult

2018-08-30T14:02:37Z

Marten Smits:

{{#customtitle:Use Cases MedMij Laboratoriumresultaten}}

[[Bestand:Labresultaten_icoon.png |link=|links |87px|MedMij_|Laboratoriumresultaten]]
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.04_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.04_FHIR_LaboratoryResults|Technisch]]
desc none
</imagemap>

=Inleiding=
Deze pagina beschrijft use cases voor de patiënt met relatie tot de [https://www.nictiz.nl/standaardisatie/informatiestandaarden/laboratoria informatiestandaard labuitwisseling] (LAB).

Door IHE / Antilope is ook al werk gedaan voor beschrijving use cases voor uitwisseling van laboratoriumgegevens, deze zijn [https://usecase-repository.ihe-europe.net/use-cases?field_domain_value=LAB&field_scale_value=All&field_source_value=All hier] gepubliceerd. Op het moment van schrijven van deze documentatie heeft IHE twee verschillende use cases beschreven:
* Uitwisseling voor een laboratorium binnen een ziekenhuis: [https://usecase-repository.ihe-europe.net/content/request-and-results-distribution-workflow-laboratory-within-hospital Request and results distribution workflow for laboratory within a hospital]
* Nationale / regionale uitwisseling tussen zorgaanbieders / laboratoria: [https://usecase-repository.ihe-europe.net/content/request-and-results-sharing-workflow-laboratory-nationalregional-scale Request and results sharing workflow for laboratory on a National/regional scale]

Bovenstaande standaarden beschrijven de uitwisseling met de patiënt nog niet expliciet. Het doel van deze pagina is om de verschillende uitwisselingsscenario's van laboratoriumgegevens met de patiënt toe te voegen.

Het is het streven van het MedMij-programma om deze beschrijvingen toe te voegen aan de bestaande informatiestandaard Labuitwisseling.

Zoals [[MedMij:V2018.04_Ontwerpen|op deze pagina]] aangegeven, gebruikt MedMij de BGZ en de bijbehorende ZIB's als leidraad voor de uitwisseling van informatie. Voor uitwisseling van laboratoriumresultaten gaat het om de volgende ZIB's:
*Patiënt;
*Zorgaanbieder;
*Zorgverlener;
*OverdrachtLaboratoriumUitslag.

=Use Cases=

==Use case: Raadplegen laboratoriumresultaten in persoonlijke gezondheidsomgeving==
===Doel en relevantie===
Het voor patiënten mogelijk maken regie op hun eigen gezondheid te nemen door inzicht te geven in laboratoriumresultaten die over henzelf gaan.
===Domein===
Laboratoriumgegevens in het domein van zorgaanbieders, laboratoria en patiënten.

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van laboratoriumresultaten vanuit zorgaanbieder / laboratorium naar een patiënt. De zorgaanbieder / laboratorium is dus de bron van de gegevens.

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
====Raadplegen laboratoriumresultaten====
Informatie-elementen in de vraag om laboratoriumresultaten zijn:
*periode (startdatum - einddatum) waarop het laboratoriumresultaat uitgevoerd was.

Dit betreft de filtermogelijkheden (query paramaters) in de vraag om laboratoriumresultaten.

====Beschikbaarstellen laboratoriumresultaat====
De volgende zorginformatiebouwstenen definiëren de informatie-elementen die van toepassing zijn:
*Patiënt
*Zorgverlener
*Zorgaanbieder
*OverdrachtLaboratoriumUitslag v1.2.2

Informatie elementen in OverdrachtLaboratoriumUitslag staan [https://zibs.nl/wiki/OverdrachtLaboratoriumUitslag-v1.2.2(2015NL) hier].

Dit betreft de inhoud van ieder laboratoriumresultaat.

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil laboratoriumresultaten raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder / Laboratorium
|style="background-color: white;vertical-align:top;"|Stelt laboratoriumresultaten beschikbaar
|}
'''Bedrijfsrollen Laboratoriumresultaten'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity_Diagram_-_LaboratoriumResultaten.jpg|Activiteitendiagram Raadplegen laboratoriumresultaten ]]

'''Activiteitendiagram Raadplegen laboratoriumresultaten'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas van Beek vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een aantal voor Thomas relevante situaties waarbij het raadplegen van laboratoriumresultaten een rol speelt.

<blockquote>Eens per drie maanden heeft Thomas een controle in het ziekenhuis. Hij heeft dan een afspraak met afwisselend de internist of de diabetesverpleegkundige. Thomas moet een half uur voor zijn afspraak al aanwezig zijn in het ziekenhuis om bloed te laten prikken. Een waarde die onder andere bepaald wordt is de HbA1c waarde, hieraan is te zien wat de gemiddelde glucosewaarde over de afgelopen 3 maanden geweest is. De uitslag is binnen een half uur binnen. De zorgverlener vertelt Thomas de laboratoriumresultaten en wat die betekenen tijdens de afspraak. Het ziekenhuis informatiesysteem maakt de laboratoriumresultaten ook beschikbaar voor de persoonlijke gezondheidsomgeving van Thomas. Thomas kan de resultaten dan ook later nog eens nakijken als hij dat wil. Dit geeft hem meer grip op zijn gezondheidssituatie.</blockquote>

<blockquote>In april is het tijd voor de jaarlijkse, uitgebreide controle in het ziekenhuis in verband met diabetes. De controle zélf zal plaatsvinden op 12 april. Thomas moet een week daarvoor, op 5 april, bloed prikken en urine afgeven in het ziekenhuis. De resultaten van de laboratoriumonderzoeken moeten beschikbaar zijn vóór 12 april. Het ziekenhuis informatiesysteem heeft de resultaten beschikbaar gemaakt voor Thomas op 10 april. Thomas wil zich goed op zijn afspraak voorbereiden en raadpleegt op 11 april, via zijn PGO, deze laboratoriumresultaten. Hij krijgt zo vooraf al meer inzicht in zijn situatie. Zijn nierwaarden lijken hem afwijkend. Hij vraagt zich daarom af of de instelling van de medicatie misschien aangepast moet worden. Voor de zekerheid noteert hij deze vraag voor zijn internist. Zo kan hij goed voorbereid naar het ziekenhuis op 12 april.</blockquote>

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het uitwisselen van laboratoriumresultaten tussen zorgaanbieder / laboratorium en patiënt.
Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.
=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van laboratoriumresultaten tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

Er is een laboratoriumresultaat dat de patiënt wil raadplegen en dat de zorgaanbiederzorgaanbieder / laboratorium beschikbaar stelt.
:Soms zijn er valide redenen om bepaalde laboratoriumresultaten tijdelijk nog niet beschikbaar te stellen aan de patiënt. Bijvoorbeeld omdat de zorgverlener deze eerst zelf wil interpreteren en/of er eerst met de patiënt over wil spreken.
:Een patiënt kan steeds zelf het initiatief nemen om laboratoriumresultaten op te halen, maar het is ook mogelijk dat een PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze use case beschrijving geen verschil.

=====Proces stappen=====
*De patiënt vraagt om laboratoriumresultaten bij een zorgaanbieder / laboratorium.
*De zorgaanbieder / laboratorium levert laboratoriumresultaten op voor de patiënt.
*Patiënt ziet de laboratoriumresultaten in.

=====Post conditie=====
De patiënt heeft laboratoriumresultaten gezien.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder / laboratorium als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder / laboratorium)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om laboratoriumresultaten van zorgaanbieder / laboratorium naar patiënt.

Een XIS vervult in deze use case de volgende systeemrol:
* LaboratoriumresultaatBeschikbaarstellend Systeem [LAB-1.0.0-LRB-FHIR]

Een PGO vervult de volgende systeemrol:
* LaboratoriumresultaatRaadplegend Systeem [LAB-1.0.0-LRR-FHIR].

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_LaboratoriumResultaten_(Totaal).jpg|Componenten diagram]]

'''Componenten diagram'''

De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Laboratoriumresultaten (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen laboratoriumresultaten
|style="background-color: white;vertical-align:top;"|LAB-1.0.0-LRR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2018.04_FHIR_LaboratoryResults|Laboratoriumresultaten in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen laboratoriumresultaten
|style="background-color: white;vertical-align:top;"|LAB-1.0.0-LRB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder (laboratorium)
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_LaboratoriumResultaten.jpg|Use case diagram raadplegen laboratoriumresultaten]]

'''Use case diagram

=Functionaliteit=
Er zijn geen aanwijzingen/eisen voor functionaliteit van de systemen.

=Verantwoordelijkheid voor informatie=
Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

=Infrastructuur=
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| AUTEUR(S)
| style="background-color: white;"| TITEL
| style="background-color: white;"| VERSIE
| style="background-color: white;"| DATUM
| style="background-color: white;"| BRON
| style="background-color: white;"| ORGANISATIE
|}
'''Referenties

MedMij:V2018.04 OntwerpeAfspraak

2018-08-30T13:13:31Z

Marten Smits:

[[Bestand:EAfspraak_icoon_zonder_tekst.png |link=|links |87px|eAfspraak]]
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.04_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.04_FHIR_eAfspraak|Tecnical]]
desc none
</imagemap>

<div class="toclimit-{{{2|{{{limit|3}}}}}}">__TOC__</div>

=Inleiding=
Deze pagina beschrijft use cases waarbij een patiënt afspraken kan raadplegen, maken, annuleren of wijzigen met behulp van een persoonlijke gezondheidsomgeving. Algemene informatie betreffende deze use cases kan gevonden worden op deze [https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.04_Ontwerpen wiki pagina].

=Use Cases=
Deze sectie vervolgt met de volgende use cases:
*[[#Use_case:_Afspraak_raadplegen_door_pati.C3.ABnt|Afspraak raadplegen]]
*[[#Use_case:_Afspraak_maken_door_pati.C3.ABnt|Afspraak maken]]
*[[#Use_case:_Afspraak_annuleren_door_pati.C3.ABnt|Afspraak annuleren]]
*[[#Use_case:_Afspraak_wijzigen_door_pati.C3.ABnt|Afspraak wijzigen]]
==Use case: Afspraak raadplegen door patiënt==
===Doel en relevantie===
Inzicht in afspraken biedt patiënten overzicht en gebruiksgemak. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van afspraken vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===

====Raadplegen afspraak ====
Het raadplegen van een afspraak gaat van een specifieke patiënt naar een specifieke organisatie in de zorg (bijvoorbeeld een zorgaanbieder).

Verdere informatie-elementen in de vraag om afspraken zijn:
*periode (startdatum - einddatum) waarin de afspraak plaats heeft gehad / heeft / zal hebben
Dit betreft dus de filtermogelijkheden (query parameters) in de vraag om afspraken.

====Beschikbaarstellen afspraak ====
De informatie-elementen voor beschikbaarstellen afspraak staan in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak]

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil afspraken raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt afspraken beschikbaar
|}
'''Bedrijfsrollen afspraak inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak raadplegen.png|Activiteitendiagram afspraak raadplegen]]

'''Activiteitendiagram afspraak raadplegen'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een aantal voor Thomas relevante situaties waarbij het raadplegen van afspraken een rol speelt.

<blockquote>Thomas heeft iedere drie maanden een controle in het ziekenhuis in verband met zijn Diabetes aandoening. De eerstkomende afspraak is op vrijdag 6 oktober 2017 om 10:30u met internist Janssen bij het Antonius Ziekenhuis in Rotterdam en duurt een uur. Het ziekenhuisinformatiesysteem heeft deze afspraak beschikbaar gemaakt voor de persoonlijke gezondheidsomgeving van Thomas. Thomas kan deze afspraak dan ook inzien via zijn persoonlijke gezondheidsomgeving.
----
Op 6 september belt de afdelingssecretaresse van het ziekenhuis. Zij heeft het verzoek aan Thomas of de afspraak verzet kan worden naar dinsdag 3 oktober om 16:00 uur. Dat komt hem prima uit, dus hij gaat akkoord. Het ziekenhuisinformatiesysteem maakt deze nieuwe afspraakinformatie beschikbaar voor de persoonlijke gezondheidsomgeving. Wanneer Thomas later die dag kijkt, ziet hij ook de bijgewerkte afspraakinformatie in zijn persoonlijke gezondheidsomgeving. Wel zo makkelijk, want hij was het eerder die dag vergeten op te schrijven.
</blockquote>

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het systeem van een zorgaanbieder (XIS) stelt de afspraak beschikbaar aan het systeem van een patiënt (PGO).
Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.
=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

De patiënt wil afspraken inzien en de zorgaanbieder stelt dit ook beschikbaar.
Een patiënt neemt steeds zelf het initiatief om zijn afspraken te raadplegen.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om afspraken in te zien.

=====Post conditie=====
De patiënt heeft afspraken geraadpleegd via de persoonlijke gezondheidsomgeving.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om afspraken van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| AfspraakRaadplegend
| style="background-color: white;"| EA-1.0.0-AFR-FHIR
| style="background-color: white;"| Raadplegen afspraak bij zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| AfspraakBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak aan de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak raadplegen (Totaal).png |Componenten diagram afspraak raadplegen]]

'''Componenten diagram afspraak raadplegen'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak raadplegen.png|Use case diagram afspraak raadplegen]]

'''Use case diagram afspraak raadplegen

==Use case: Afspraak maken door patiënt==
===Doel en relevantie===
Het maken van afspraken via een persoonlijke gezondheidsomgeving biedt patiënten gebruiksgemak. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het elektronisch en gestructureerd afspraken kunnen maken vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn vastgelegd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots

Sturen afspraakverzoek
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots

Ontvangen afspraak verzoek
|}
'''Bedrijfsrollen Afspraak inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak maken.png|Activiteitendiagram afspraak maken]]

'''Activiteitendiagram maken afspraak'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het maken van afspraken een rol speelt.

<blockquote>De persoonlijke gezondheidsomgeving van Thomas en het ziekenhuisinformatiesysteem (ZIS) van het Noorderziekenhuis in Groningen zijn verbonden vanwege een eerder bezoek van Thomas in het ziekenhuis.

Thomas wil een afspraak maken voor de driemaandelijkse controle met een diabetesverpleegkundige. Hij wil dit ergens in de tweede week van januari. Zijn persoonlijke gezondheidsomgeving haalt de beschikbare tijden voor deze afspraak op uit het Groningse ziekenhuisinformatiesysteem. Thomas kiest voor woensdag 10 januari van 14:00 – 15:00 uur. Dit verzoek gaat via zijn persoonlijke gezondheidsomgeving naar het ziekenhuisinformatiesysteem, dat de ontvangst van dit verzoek bevestigt. De afspraak is door Thomas te raadplegen via zijn persoonlijke gezondheidsomgeving.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Een persoonlijke gezondheidsomgeving kan voor een bepaalde periode én een bepaald type afspraak de beschikbare tijden ophalen uit het XIS. Dit betreft het raadplegen van beschikbare afspraak slots. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan - op basis van beschikbare slots - een verzoek tot het maken van een concrete afspraak doen aan het XIS. Een XIS kan een dergelijk afspraakverzoek wel/niet in behandeling nemen en stuurt daarvan een bevestiging.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch maken van afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil bepaalde typen afspraken maken en de zorgaanbieder ondersteunt het maken van deze afspraken.

=====Proces stappen=====
*Het systeem van de zorgaanbieder (XIS) levert de beschikbare afspraak slots op basis van de filter criteria uit de persoonlijke gezondheidsomgeving.
*Het systeem van de patiënt (PGO) stuurt een verzoek om een bepaald type afspraak te maken in een bepaalde slot.
*Het systeem van de zorgaanbieder (XIS) ontvangt het afspraakverzoek en geeft een technisch antwoord. Het antwoord geeft aan of het verzoek wel of niet in behandeling genomen kan worden.

Indien een verzoek in behandeling genomen kan worden door XIS, dan kan verwerking enige tijd vergen. Het verzoek wordt niet altijd direct afgehandeld.

Bij een eventueel negatief antwoord van het XIS kan een patiënt ervoor kiezen het opnieuw proberen, bijvoorbeeld met een ander (opnieuw opgevraagd) slot.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een afspraakverzoek.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| AfspraakSlotsRaadplegend
| style="background-color: white;"| EA-1.0.0-ASR-FHIR
| style="background-color: white;"| Raadplegen afspraak slots bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakverzoekSturend
| style="background-color: white;"| EA-1.0.0-AVS-FHIR
| style="background-color: white;"| Sturen afspraakverzoek naar zorgaanbieder
|-
| style="background-color: white;"| AfspraakSlotsBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ASB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak slots
|-
| style="background-color: white;"| AfspraakverzoekOntvangend
| style="background-color: white;"| EA-1.0.0-AVO-FHIR
| style="background-color: white;"| Ontvangen afspraakverzoek van de patient
|-
|}
Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak maken (Totaal).png|Componenten diagram afspraak maken]]

'''Componenten diagram afspraak maken'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakSlots (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="6"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakVerzoek (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraakverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AVS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraakverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AVO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak maken.png|Use case diagram afspraak maken]]

'''Use case diagram afspraak maken

==Use case: Afspraak annuleren door patiënt==
===Doel en relevantie===
Inzicht in afspraken biedt patiënten overzicht en gebruiksgemak. Dat is een functionaliteit die voorwaardelijk is voor deze use case: 'annuleren van afspraken'. Een patiënt is verder geholpen door ook afspraken te kunnen annuleren vanuit een persoonlijke gezondheidsomgeving. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het kunnen annuleren van een afspraak vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn gedefinieerd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
Sturen afspraak annulering
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
Ontvangen afspraak annulering
|}
'''Bedrijfsrollen afspraken inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak annuleren.png|Activiteitendiagram afspraak annuleren]]

'''Activiteitendiagram afspraak annuleren'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het annuleren van afspraken een rol speelt.

<blockquote>Thomas verhuist halverwege oktober 2017 voor zijn afstuderen naar Groningen. De afspraak voor de driemaandelijkse controle was al gemaakt in Rotterdam voor vrijdag 5 januari 2018. Thomas wil nu die afspraak afzeggen omdat hij die dag bezet is vanwege zijn afstudeerstage. Een nieuwe afspraak maakt hij liever in Groningen, dat is voor hem nu veel handiger.
Hij gebruikt zijn PGO om een verzoek te doen de afspraak in Rotterdam te annuleren. Een aantal uren later bevestigt de medisch secretaresse deze annulering. Thomas kan de afspraken weer raadplegen via zijn PGO.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Een persoonlijke gezondheidsomgeving kan achterhalen welk afspraken het verbonden XIS heeft voor de patiënt. Dit betreft het raadplegen van afspraken. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan voor een bestaande afspraak een verzoek doen tot annulering. Een XIS ontvangt, behandelt en beantwoordt een dergelijk verzoek.

Een PGO heeft afspraken geraadpleegd en opvolging verzoek beoordeeld. Mocht het verzoek niet verwerkt zijn, kan een patiënt ervoor kiezen het opnieuw te proberen, of op een andere manier de zorgaanbieder te benaderen. Indien het verzoek verwerkt is, stelt XIS bij raadpleging door PGO de afspraak met status ‘geannuleerd’ beschikbaar.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van informatie over afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil bepaalde afspraken kunnen annuleren en de zorgaanbieder ondersteunt dit.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) raadpleegt de beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Het systeem van de patiënt (PGO) stuurt een verzoek om de bestaande afspraak te annuleren.
*Het systeem van de zorgaanbieder (XIS) ontvangt de annulering en geeft een technisch antwoord. Het antwoord kan positief of negatief zijn voor het doorvoeren van de annulering.
*Het systeem van de patiënt (PGO) raadpleegt de beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken (waaronder de geannuleerde afspraak met status 'geannuleerd') op voor de patiënt.

Indien het verzoek verwerkt kan worden, stelt XIS de afspraak met status 'geannuleerd' beschikbaar, na raadpleging door patiënt vanuit zijn PGO.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een verzoek tot annulering van een afspraak.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="2"| PGO
| style="background-color: white;"| AfsprakenRaadplegend
| style="background-color: white;"| EA-1.0.0-AFR-FHIR
| style="background-color: white;"| Raadplegen afspraken bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakAnnuleringSturend
| style="background-color: white;"| EA-1.0.0-AAS-FHIR
| style="background-color: white;"| Sturen afspraak annulering naar de zorgaanbieder
|-
| style="background-color: white;" rowspan="2"| XIS
| style="background-color: white;"| AfsprakenBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraken aan de patiënt
|-
| style="background-color: white;"| AfspraakAnnuleringOntvangend
| style="background-color: white;"| EA-1.0.0-AAO-FHIR
| style="background-color: white;"| Ontvangen afspraak annulering van de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak annuleren (Totaal).png |Componenten diagram afspraak annuleren]]

'''Componenten diagram afspraak annuleren'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="4"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakAnnulering (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraak annulering
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AAS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraak annulering
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AAO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak annuleren.png |Use case diagram afspraak annuleren]]

'''Use case diagram afspraak annuleren

==Use case: Afspraak wijzigen door patiënt==
===Doel en relevantie===
Inzicht in en het maken van afspraken biedt patiënten overzicht en gebruiksgemak. Dat zijn functionaliteiten die voorwaardelijk zijn voor deze use case: 'wijzigen van afspraken'. Een patiënt is verder geholpen door ook afspraken te kunnen wijzigen vanuit een persoonlijke gezondheidsomgeving. Een wijziging kan ook een annulering betreffen. Dit draagt verder bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het kunnen wijzigen van een afspraak vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn gedefinieerd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak

Raadplegen afspraak slots

Sturen afspraak wijzigingsverzoek
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak

Beschikbaarstellen afspraak slots

Ontvangen afspraak wijzigingsverzoek
|}
'''Bedrijfsrollen afspraken inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak wijzigen.png|Activiteitendiagram afspraak wijzigen]]

'''Activiteitendiagram afspraak wijzigen'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het wijzigen van afspraken een rol speelt.

<blockquote>In de loop van december krijgt Thomas een buitenkansje. Een aantal van zijn vrienden gaan met skivakantie van zaterdag 5 t/m 12 januari en er is een plekje vrijgekomen. Voor een zacht prijsje kan hij mee. Daar heeft hij veel zin in!

Thomas zet de skivakantie ‘s avonds laat in zijn agenda en ziet dat dit conflicteert met zijn controle-afspraak in het Noorderziekenhuis op 10 januari. Hij moet die afspraak gaan verzetten. Het is 23:15 en dus te laat om het ziekenhuis hiervoor direct te bellen.

Via zijn PGO kijkt hij daarom naar beschikbare tijden in de derde week van januari. Er blijkt gelukkig nog een gaatje te zijn op vrijdag 19 januari om 11:30 – 12:30. Het verzoek om te wijzigen gaat via zijn PGO naar het ZIS, dat de ontvangst van het verzoek bevestigt. Bij raadpleging van de afspraken vanuit PGO, stelt XIS de nieuwe afspraak beschikbaar, alsmede de oorspronkelijke afspraak met status ‘ geannuleerd’.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Het systeem van een zorgaanbieder (XIS) stelt afspraken beschikbaar aan het systeem van een patiënt (PGO).
*Een persoonlijke gezondheidsomgeving kan voor een bepaalde periode én een bepaald type afspraak de beschikbare tijden ophalen uit het XIS. Dit betreft het raadplegen van beschikbare afspraak slots. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan - op basis van beschikbare slots - een verzoek tot het wijzigen van een concrete afspraak doen aan het XIS. Een XIS kan een dergelijk afspraak wijzigingsverzoek behandelen en ontvangst van het verzoek bevestigen.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van informatie over afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil een afspraak wijzigen en de zorgaanbieder ondersteunt het wijzigen van afspraken.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om afspraken in te zien en er één te selecteren die hij wil wijzigen.
*Het systeem van de patiënt (PGO) vraagt om beschikbare slots voor een bepaald type afspraak in een bepaalde tijdsperiode bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de beschikbare afspraak slots op basis van de filter criteria uit de persoonlijke gezondheidsomgeving.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om beschikbare slots in te zien en er één te selecteren.
*Het systeem van de patiënt (PGO) stuurt een verzoek om de bestaande afspraak te wijzigen.
*Het systeem van de zorgaanbieder (XIS) ontvangt het afspraak wijzigingsverzoek en geeft een technisch antwoord. Het antwoord kan positief of negatief zijn voor de wijziging.

Patiënt raadpleegt opnieuw de afspraken vanuit zijn PGO + XIS stelt de nieuwe afspraak beschikbaar, alsmede de oorspronkelijke afspraak met status ‘geannuleerd’.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een afspraak wijzigingsverzoek.

Bij een eventueel negatief antwoord van het XIS kan een patiënt ervoor kiezen het opnieuw proberen, bijvoorbeeld met een ander (opnieuw opgevraagd) slot.
Bij een positief antwoord is de afspraak gewijzigd en inzichtelijk in zowel XIS als PGO.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="4"| PGO
| style="background-color: white;"| AfspraakRaadplegend
| style="background-color: white;"| EA-1.0.0-AFO-FHIR
| style="background-color: white;"| Raadplegen afspraak bij zorgaanbieder
|-
| style="background-color: white;"| AfspraakSlotsRaadplegend
| style="background-color: white;"| EA-1.0.0-ASR-FHIR
| style="background-color: white;"| Raadplegen afspraak slots bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakWijzigingsverzoekSturend
| style="background-color: white;"| EA-1.0.0-AWS-FHIR
| style="background-color: white;"| Sturen afspraak wijzigingsverzoek
|-
| style="background-color: white;" rowspan="4"| XIS
| style="background-color: white;"| AfspraakBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak aan de patiënt
|-
| style="background-color: white;"| AfspraakSlotsBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ASB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak slots
|-
| style="background-color: white;"| AfspraakWijzigingsverzoekOntvangend
| style="background-color: white;"| EA-1.0.0-AWO-FHIR
| style="background-color: white;"| Ontvangen afspraak wijzigingsverzoek van de patiënt.
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak wijzigen (Totaal).png|Componenten diagram afspraak wijzigen]]

'''Componenten diagram afspraak wijzigen'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="8"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakSlots (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakWijziging (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraak wijzigingsverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AWS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraak wijzigingsverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AWO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak wijzigen.png|Use case diagram afspraak wijzigen]]

'''Use case diagram afspraak wijzigen

=Functionaliteit=
-

=Verantwoordelijkheid voor informatie=
Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

=Infrastructuur=
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| AUTEUR(S)
| style="background-color: white;"| TITEL
| style="background-color: white;"| VERSIE
| style="background-color: white;"| DATUM
| style="background-color: white;"| BRON
| style="background-color: white;"| ORGANISATIE
|}
'''Referenties

MedMij:V2018.04 OntwerpeAfspraak

2018-08-30T13:08:22Z

Marten Smits:

{{#customtitle:Use Cases eAfspraak, draft version}}
{{IssueBox|Dit is een werkpagina.

De gepubliceerde versie kan hier gevonden worden: https://informatiestandaarden.nictiz.nl/wiki/MedMij:Vcurrent_Ontwerpen}}
[[Bestand:EAfspraak_icoon_zonder_tekst.png |link=|links |87px|eAfspraak]]
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.04_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.04_FHIR_eAfspraak|Tecnical]]
desc none
</imagemap>

<div class="toclimit-{{{2|{{{limit|3}}}}}}">__TOC__</div>

=Inleiding=
Deze pagina beschrijft use cases waarbij een patiënt afspraken kan raadplegen, maken, annuleren of wijzigen met behulp van een persoonlijke gezondheidsomgeving. Algemene informatie betreffende deze use cases kan gevonden worden op deze [https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.04_Ontwerpen wiki pagina].

=Use Cases=
Deze sectie vervolgt met de volgende use cases:
*[[#Use_case:_Afspraak_raadplegen_door_pati.C3.ABnt|Afspraak raadplegen]]
*[[#Use_case:_Afspraak_maken_door_pati.C3.ABnt|Afspraak maken]]
*[[#Use_case:_Afspraak_annuleren_door_pati.C3.ABnt|Afspraak annuleren]]
*[[#Use_case:_Afspraak_wijzigen_door_pati.C3.ABnt|Afspraak wijzigen]]
==Use case: Afspraak raadplegen door patiënt==
===Doel en relevantie===
Inzicht in afspraken biedt patiënten overzicht en gebruiksgemak. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van afspraken vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===

====Raadplegen afspraak ====
Het raadplegen van een afspraak gaat van een specifieke patiënt naar een specifieke organisatie in de zorg (bijvoorbeeld een zorgaanbieder).

Verdere informatie-elementen in de vraag om afspraken zijn:
*periode (startdatum - einddatum) waarin de afspraak plaats heeft gehad / heeft / zal hebben
Dit betreft dus de filtermogelijkheden (query parameters) in de vraag om afspraken.

====Beschikbaarstellen afspraak ====
De informatie-elementen voor beschikbaarstellen afspraak staan in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak]

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil afspraken raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt afspraken beschikbaar
|}
'''Bedrijfsrollen afspraak inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak raadplegen.png|Activiteitendiagram afspraak raadplegen]]

'''Activiteitendiagram afspraak raadplegen'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een aantal voor Thomas relevante situaties waarbij het raadplegen van afspraken een rol speelt.

<blockquote>Thomas heeft iedere drie maanden een controle in het ziekenhuis in verband met zijn Diabetes aandoening. De eerstkomende afspraak is op vrijdag 6 oktober 2017 om 10:30u met internist Janssen bij het Antonius Ziekenhuis in Rotterdam en duurt een uur. Het ziekenhuisinformatiesysteem heeft deze afspraak beschikbaar gemaakt voor de persoonlijke gezondheidsomgeving van Thomas. Thomas kan deze afspraak dan ook inzien via zijn persoonlijke gezondheidsomgeving.
----
Op 6 september belt de afdelingssecretaresse van het ziekenhuis. Zij heeft het verzoek aan Thomas of de afspraak verzet kan worden naar dinsdag 3 oktober om 16:00 uur. Dat komt hem prima uit, dus hij gaat akkoord. Het ziekenhuisinformatiesysteem maakt deze nieuwe afspraakinformatie beschikbaar voor de persoonlijke gezondheidsomgeving. Wanneer Thomas later die dag kijkt, ziet hij ook de bijgewerkte afspraakinformatie in zijn persoonlijke gezondheidsomgeving. Wel zo makkelijk, want hij was het eerder die dag vergeten op te schrijven.
</blockquote>

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het systeem van een zorgaanbieder (XIS) stelt de afspraak beschikbaar aan het systeem van een patiënt (PGO).
Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.
=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

De patiënt wil afspraken inzien en de zorgaanbieder stelt dit ook beschikbaar.
Een patiënt neemt steeds zelf het initiatief om zijn afspraken te raadplegen.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om afspraken in te zien.

=====Post conditie=====
De patiënt heeft afspraken geraadpleegd via de persoonlijke gezondheidsomgeving.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om afspraken van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| AfspraakRaadplegend
| style="background-color: white;"| EA-1.0.0-AFR-FHIR
| style="background-color: white;"| Raadplegen afspraak bij zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| AfspraakBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak aan de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak raadplegen (Totaal).png |Componenten diagram afspraak raadplegen]]

'''Componenten diagram afspraak raadplegen'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak raadplegen.png|Use case diagram afspraak raadplegen]]

'''Use case diagram afspraak raadplegen

==Use case: Afspraak maken door patiënt==
===Doel en relevantie===
Het maken van afspraken via een persoonlijke gezondheidsomgeving biedt patiënten gebruiksgemak. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het elektronisch en gestructureerd afspraken kunnen maken vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn vastgelegd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots

Sturen afspraakverzoek
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots

Ontvangen afspraak verzoek
|}
'''Bedrijfsrollen Afspraak inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak maken.png|Activiteitendiagram afspraak maken]]

'''Activiteitendiagram maken afspraak'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het maken van afspraken een rol speelt.

<blockquote>De persoonlijke gezondheidsomgeving van Thomas en het ziekenhuisinformatiesysteem (ZIS) van het Noorderziekenhuis in Groningen zijn verbonden vanwege een eerder bezoek van Thomas in het ziekenhuis.

Thomas wil een afspraak maken voor de driemaandelijkse controle met een diabetesverpleegkundige. Hij wil dit ergens in de tweede week van januari. Zijn persoonlijke gezondheidsomgeving haalt de beschikbare tijden voor deze afspraak op uit het Groningse ziekenhuisinformatiesysteem. Thomas kiest voor woensdag 10 januari van 14:00 – 15:00 uur. Dit verzoek gaat via zijn persoonlijke gezondheidsomgeving naar het ziekenhuisinformatiesysteem, dat de ontvangst van dit verzoek bevestigt. De afspraak is door Thomas te raadplegen via zijn persoonlijke gezondheidsomgeving.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Een persoonlijke gezondheidsomgeving kan voor een bepaalde periode én een bepaald type afspraak de beschikbare tijden ophalen uit het XIS. Dit betreft het raadplegen van beschikbare afspraak slots. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan - op basis van beschikbare slots - een verzoek tot het maken van een concrete afspraak doen aan het XIS. Een XIS kan een dergelijk afspraakverzoek wel/niet in behandeling nemen en stuurt daarvan een bevestiging.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch maken van afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil bepaalde typen afspraken maken en de zorgaanbieder ondersteunt het maken van deze afspraken.

=====Proces stappen=====
*Het systeem van de zorgaanbieder (XIS) levert de beschikbare afspraak slots op basis van de filter criteria uit de persoonlijke gezondheidsomgeving.
*Het systeem van de patiënt (PGO) stuurt een verzoek om een bepaald type afspraak te maken in een bepaalde slot.
*Het systeem van de zorgaanbieder (XIS) ontvangt het afspraakverzoek en geeft een technisch antwoord. Het antwoord geeft aan of het verzoek wel of niet in behandeling genomen kan worden.

Indien een verzoek in behandeling genomen kan worden door XIS, dan kan verwerking enige tijd vergen. Het verzoek wordt niet altijd direct afgehandeld.

Bij een eventueel negatief antwoord van het XIS kan een patiënt ervoor kiezen het opnieuw proberen, bijvoorbeeld met een ander (opnieuw opgevraagd) slot.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een afspraakverzoek.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| AfspraakSlotsRaadplegend
| style="background-color: white;"| EA-1.0.0-ASR-FHIR
| style="background-color: white;"| Raadplegen afspraak slots bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakverzoekSturend
| style="background-color: white;"| EA-1.0.0-AVS-FHIR
| style="background-color: white;"| Sturen afspraakverzoek naar zorgaanbieder
|-
| style="background-color: white;"| AfspraakSlotsBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ASB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak slots
|-
| style="background-color: white;"| AfspraakverzoekOntvangend
| style="background-color: white;"| EA-1.0.0-AVO-FHIR
| style="background-color: white;"| Ontvangen afspraakverzoek van de patient
|-
|}
Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak maken (Totaal).png|Componenten diagram afspraak maken]]

'''Componenten diagram afspraak maken'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakSlots (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="6"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakVerzoek (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraakverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AVS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraakverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AVO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak maken.png|Use case diagram afspraak maken]]

'''Use case diagram afspraak maken

==Use case: Afspraak annuleren door patiënt==
===Doel en relevantie===
Inzicht in afspraken biedt patiënten overzicht en gebruiksgemak. Dat is een functionaliteit die voorwaardelijk is voor deze use case: 'annuleren van afspraken'. Een patiënt is verder geholpen door ook afspraken te kunnen annuleren vanuit een persoonlijke gezondheidsomgeving. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het kunnen annuleren van een afspraak vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn gedefinieerd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
Sturen afspraak annulering
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
Ontvangen afspraak annulering
|}
'''Bedrijfsrollen afspraken inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak annuleren.png|Activiteitendiagram afspraak annuleren]]

'''Activiteitendiagram afspraak annuleren'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het annuleren van afspraken een rol speelt.

<blockquote>Thomas verhuist halverwege oktober 2017 voor zijn afstuderen naar Groningen. De afspraak voor de driemaandelijkse controle was al gemaakt in Rotterdam voor vrijdag 5 januari 2018. Thomas wil nu die afspraak afzeggen omdat hij die dag bezet is vanwege zijn afstudeerstage. Een nieuwe afspraak maakt hij liever in Groningen, dat is voor hem nu veel handiger.
Hij gebruikt zijn PGO om een verzoek te doen de afspraak in Rotterdam te annuleren. Een aantal uren later bevestigt de medisch secretaresse deze annulering. Thomas kan de afspraken weer raadplegen via zijn PGO.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Een persoonlijke gezondheidsomgeving kan achterhalen welk afspraken het verbonden XIS heeft voor de patiënt. Dit betreft het raadplegen van afspraken. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan voor een bestaande afspraak een verzoek doen tot annulering. Een XIS ontvangt, behandelt en beantwoordt een dergelijk verzoek.

Een PGO heeft afspraken geraadpleegd en opvolging verzoek beoordeeld. Mocht het verzoek niet verwerkt zijn, kan een patiënt ervoor kiezen het opnieuw te proberen, of op een andere manier de zorgaanbieder te benaderen. Indien het verzoek verwerkt is, stelt XIS bij raadpleging door PGO de afspraak met status ‘geannuleerd’ beschikbaar.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van informatie over afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil bepaalde afspraken kunnen annuleren en de zorgaanbieder ondersteunt dit.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) raadpleegt de beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Het systeem van de patiënt (PGO) stuurt een verzoek om de bestaande afspraak te annuleren.
*Het systeem van de zorgaanbieder (XIS) ontvangt de annulering en geeft een technisch antwoord. Het antwoord kan positief of negatief zijn voor het doorvoeren van de annulering.
*Het systeem van de patiënt (PGO) raadpleegt de beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken (waaronder de geannuleerde afspraak met status 'geannuleerd') op voor de patiënt.

Indien het verzoek verwerkt kan worden, stelt XIS de afspraak met status 'geannuleerd' beschikbaar, na raadpleging door patiënt vanuit zijn PGO.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een verzoek tot annulering van een afspraak.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="2"| PGO
| style="background-color: white;"| AfsprakenRaadplegend
| style="background-color: white;"| EA-1.0.0-AFR-FHIR
| style="background-color: white;"| Raadplegen afspraken bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakAnnuleringSturend
| style="background-color: white;"| EA-1.0.0-AAS-FHIR
| style="background-color: white;"| Sturen afspraak annulering naar de zorgaanbieder
|-
| style="background-color: white;" rowspan="2"| XIS
| style="background-color: white;"| AfsprakenBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraken aan de patiënt
|-
| style="background-color: white;"| AfspraakAnnuleringOntvangend
| style="background-color: white;"| EA-1.0.0-AAO-FHIR
| style="background-color: white;"| Ontvangen afspraak annulering van de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak annuleren (Totaal).png |Componenten diagram afspraak annuleren]]

'''Componenten diagram afspraak annuleren'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="4"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakAnnulering (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraak annulering
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AAS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraak annulering
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AAO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak annuleren.png |Use case diagram afspraak annuleren]]

'''Use case diagram afspraak annuleren

==Use case: Afspraak wijzigen door patiënt==
===Doel en relevantie===
Inzicht in en het maken van afspraken biedt patiënten overzicht en gebruiksgemak. Dat zijn functionaliteiten die voorwaardelijk zijn voor deze use case: 'wijzigen van afspraken'. Een patiënt is verder geholpen door ook afspraken te kunnen wijzigen vanuit een persoonlijke gezondheidsomgeving. Een wijziging kan ook een annulering betreffen. Dit draagt verder bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het kunnen wijzigen van een afspraak vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn gedefinieerd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak

Raadplegen afspraak slots

Sturen afspraak wijzigingsverzoek
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak

Beschikbaarstellen afspraak slots

Ontvangen afspraak wijzigingsverzoek
|}
'''Bedrijfsrollen afspraken inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak wijzigen.png|Activiteitendiagram afspraak wijzigen]]

'''Activiteitendiagram afspraak wijzigen'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het wijzigen van afspraken een rol speelt.

<blockquote>In de loop van december krijgt Thomas een buitenkansje. Een aantal van zijn vrienden gaan met skivakantie van zaterdag 5 t/m 12 januari en er is een plekje vrijgekomen. Voor een zacht prijsje kan hij mee. Daar heeft hij veel zin in!

Thomas zet de skivakantie ‘s avonds laat in zijn agenda en ziet dat dit conflicteert met zijn controle-afspraak in het Noorderziekenhuis op 10 januari. Hij moet die afspraak gaan verzetten. Het is 23:15 en dus te laat om het ziekenhuis hiervoor direct te bellen.

Via zijn PGO kijkt hij daarom naar beschikbare tijden in de derde week van januari. Er blijkt gelukkig nog een gaatje te zijn op vrijdag 19 januari om 11:30 – 12:30. Het verzoek om te wijzigen gaat via zijn PGO naar het ZIS, dat de ontvangst van het verzoek bevestigt. Bij raadpleging van de afspraken vanuit PGO, stelt XIS de nieuwe afspraak beschikbaar, alsmede de oorspronkelijke afspraak met status ‘ geannuleerd’.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Het systeem van een zorgaanbieder (XIS) stelt afspraken beschikbaar aan het systeem van een patiënt (PGO).
*Een persoonlijke gezondheidsomgeving kan voor een bepaalde periode én een bepaald type afspraak de beschikbare tijden ophalen uit het XIS. Dit betreft het raadplegen van beschikbare afspraak slots. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan - op basis van beschikbare slots - een verzoek tot het wijzigen van een concrete afspraak doen aan het XIS. Een XIS kan een dergelijk afspraak wijzigingsverzoek behandelen en ontvangst van het verzoek bevestigen.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van informatie over afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil een afspraak wijzigen en de zorgaanbieder ondersteunt het wijzigen van afspraken.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om afspraken in te zien en er één te selecteren die hij wil wijzigen.
*Het systeem van de patiënt (PGO) vraagt om beschikbare slots voor een bepaald type afspraak in een bepaalde tijdsperiode bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de beschikbare afspraak slots op basis van de filter criteria uit de persoonlijke gezondheidsomgeving.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om beschikbare slots in te zien en er één te selecteren.
*Het systeem van de patiënt (PGO) stuurt een verzoek om de bestaande afspraak te wijzigen.
*Het systeem van de zorgaanbieder (XIS) ontvangt het afspraak wijzigingsverzoek en geeft een technisch antwoord. Het antwoord kan positief of negatief zijn voor de wijziging.

Patiënt raadpleegt opnieuw de afspraken vanuit zijn PGO + XIS stelt de nieuwe afspraak beschikbaar, alsmede de oorspronkelijke afspraak met status ‘geannuleerd’.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een afspraak wijzigingsverzoek.

Bij een eventueel negatief antwoord van het XIS kan een patiënt ervoor kiezen het opnieuw proberen, bijvoorbeeld met een ander (opnieuw opgevraagd) slot.
Bij een positief antwoord is de afspraak gewijzigd en inzichtelijk in zowel XIS als PGO.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="4"| PGO
| style="background-color: white;"| AfspraakRaadplegend
| style="background-color: white;"| EA-1.0.0-AFO-FHIR
| style="background-color: white;"| Raadplegen afspraak bij zorgaanbieder
|-
| style="background-color: white;"| AfspraakSlotsRaadplegend
| style="background-color: white;"| EA-1.0.0-ASR-FHIR
| style="background-color: white;"| Raadplegen afspraak slots bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakWijzigingsverzoekSturend
| style="background-color: white;"| EA-1.0.0-AWS-FHIR
| style="background-color: white;"| Sturen afspraak wijzigingsverzoek
|-
| style="background-color: white;" rowspan="4"| XIS
| style="background-color: white;"| AfspraakBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak aan de patiënt
|-
| style="background-color: white;"| AfspraakSlotsBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ASB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak slots
|-
| style="background-color: white;"| AfspraakWijzigingsverzoekOntvangend
| style="background-color: white;"| EA-1.0.0-AWO-FHIR
| style="background-color: white;"| Ontvangen afspraak wijzigingsverzoek van de patiënt.
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak wijzigen (Totaal).png|Componenten diagram afspraak wijzigen]]

'''Componenten diagram afspraak wijzigen'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="8"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakSlots (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakWijziging (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraak wijzigingsverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AWS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraak wijzigingsverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AWO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak wijzigen.png|Use case diagram afspraak wijzigen]]

'''Use case diagram afspraak wijzigen

=Functionaliteit=
-

=Verantwoordelijkheid voor informatie=
Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

=Infrastructuur=
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| AUTEUR(S)
| style="background-color: white;"| TITEL
| style="background-color: white;"| VERSIE
| style="background-color: white;"| DATUM
| style="background-color: white;"| BRON
| style="background-color: white;"| ORGANISATIE
|}
'''Referenties

MedMij:V2018.04 OntwerpeAfspraak

2018-08-30T13:07:31Z

Marten Smits:

{{#customtitle:Use Cases eAfspraak, draft version}}
{{IssueBox|Dit is een werkpagina.

De gepubliceerde versie kan hier gevonden worden: https://informatiestandaarden.nictiz.nl/wiki/MedMij:Vcurrent_Ontwerpen}}
[[Bestand:EAfspraak_icoon_zonder_tekst.png |link=|links |87px|eAfspraak]]
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.04_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.04_FHIR_eAfspraak|Tecnical]]
desc none
</imagemap>

<div class="toclimit-{{{2|{{{limit|3}}}}}}">__TOC__</div>

=Inleiding=
Deze pagina beschrijft use cases waarbij een patiënt afspraken kan raadplegen, maken, annuleren of wijzigen met behulp van een persoonlijke gezondheidsomgeving. Algemene informatie betreffende deze use cases kan gevonden worden op deze [https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.04_Ontwerpen wiki pagina].

=Use Cases=
Deze sectie vervolgt met de volgende use cases:
*[[#Use_case:_Afspraak_raadplegen_door_pati.C3.ABnt|Afspraak raadplegen]]
*[[#Use_case:_Afspraak_maken_door_pati.C3.ABnt|Afspraak maken]]
*[[#Use_case:_Afspraak_annuleren_door_pati.C3.ABnt|Afspraak annuleren]]
*[[#Use_case:_Afspraak_wijzigen_door_pati.C3.ABnt|Afspraak wijzigen]]
==Use case: Afspraak raadplegen door patiënt==
===Doel en relevantie===
Inzicht in afspraken biedt patiënten overzicht en gebruiksgemak. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van afspraken vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===

====Raadplegen afspraak ====
Het raadplegen van een afspraak gaat van een specifieke patiënt naar een specifieke organisatie in de zorg (bijvoorbeeld een zorgaanbieder).

Verdere informatie-elementen in de vraag om afspraken zijn:
*periode (startdatum - einddatum) waarin de afspraak plaats heeft gehad / heeft / zal hebben
Dit betreft dus de filtermogelijkheden (query parameters) in de vraag om afspraken.

====Beschikbaarstellen afspraak ====
De informatie-elementen voor beschikbaarstellen afspraak staan in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak]

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil afspraken raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt afspraken beschikbaar
|}
'''Bedrijfsrollen afspraak inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak raadplegen.png|Activiteitendiagram afspraak raadplegen]]

'''Activiteitendiagram afspraak raadplegen'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een aantal voor Thomas relevante situaties waarbij het raadplegen van afspraken een rol speelt.

<blockquote>Thomas heeft iedere drie maanden een controle in het ziekenhuis in verband met zijn Diabetes aandoening. De eerstkomende afspraak is op vrijdag 6 oktober 2017 om 10:30u met internist Janssen bij het Antonius Ziekenhuis in Rotterdam en duurt een uur. Het ziekenhuisinformatiesysteem heeft deze afspraak beschikbaar gemaakt voor de persoonlijke gezondheidsomgeving van Thomas. Thomas kan deze afspraak dan ook inzien via zijn persoonlijke gezondheidsomgeving.
----
Op 6 september belt de afdelingssecretaresse van het ziekenhuis. Zij heeft het verzoek aan Thomas of de afspraak verzet kan worden naar dinsdag 3 oktober om 16:00 uur. Dat komt hem prima uit, dus hij gaat akkoord. Het ziekenhuisinformatiesysteem maakt deze nieuwe afspraakinformatie beschikbaar voor de persoonlijke gezondheidsomgeving. Wanneer Thomas later die dag kijkt, ziet hij ook de bijgewerkte afspraakinformatie in zijn persoonlijke gezondheidsomgeving. Wel zo makkelijk, want hij was het eerder die dag vergeten op te schrijven.
</blockquote>

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het systeem van een zorgaanbieder (XIS) stelt de afspraak beschikbaar aan het systeem van een patiënt (PGO).
Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.
=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

De patiënt wil afspraken inzien en de zorgaanbieder stelt dit ook beschikbaar.
Een patiënt neemt steeds zelf het initiatief om zijn afspraken te raadplegen.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om afspraken in te zien.

=====Post conditie=====
De patiënt heeft afspraken geraadpleegd via de persoonlijke gezondheidsomgeving.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om afspraken van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| AfspraakRaadplegend
| style="background-color: white;"| EA-1.0.0-AFR-FHIR
| style="background-color: white;"| Raadplegen afspraak bij zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| AfspraakBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak aan de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak raadplegen (Totaal).png |Componenten diagram afspraak raadplegen]]

'''Componenten diagram afspraak raadplegen'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak raadplegen.png|Use case diagram afspraak raadplegen]]

'''Use case diagram afspraak raadplegen

==Use case: Afspraak maken door patiënt==
===Doel en relevantie===
Het maken van afspraken via een persoonlijke gezondheidsomgeving biedt patiënten gebruiksgemak. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het elektronisch en gestructureerd afspraken kunnen maken vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn vastgelegd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots

Sturen afspraakverzoek
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots

Ontvangen afspraak verzoek
|}
'''Bedrijfsrollen Afspraak inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak maken.png|Activiteitendiagram afspraak maken]]

'''Activiteitendiagram maken afspraak'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het maken van afspraken een rol speelt.

<blockquote>De persoonlijke gezondheidsomgeving van Thomas en het ziekenhuisinformatiesysteem (ZIS) van het Noorderziekenhuis in Groningen zijn verbonden vanwege een eerder bezoek van Thomas in het ziekenhuis.

Thomas wil een afspraak maken voor de driemaandelijkse controle met een diabetesverpleegkundige. Hij wil dit ergens in de tweede week van januari. Zijn persoonlijke gezondheidsomgeving haalt de beschikbare tijden voor deze afspraak op uit het Groningse ziekenhuisinformatiesysteem. Thomas kiest voor woensdag 10 januari van 14:00 – 15:00 uur. Dit verzoek gaat via zijn persoonlijke gezondheidsomgeving naar het ziekenhuisinformatiesysteem, dat de ontvangst van dit verzoek bevestigt. De afspraak is door Thomas te raadplegen via zijn persoonlijke gezondheidsomgeving.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Een persoonlijke gezondheidsomgeving kan voor een bepaalde periode én een bepaald type afspraak de beschikbare tijden ophalen uit het XIS. Dit betreft het raadplegen van beschikbare afspraak slots. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan - op basis van beschikbare slots - een verzoek tot het maken van een concrete afspraak doen aan het XIS. Een XIS kan een dergelijk afspraakverzoek wel/niet in behandeling nemen en stuurt daarvan een bevestiging.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch maken van afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil bepaalde typen afspraken maken en de zorgaanbieder ondersteunt het maken van deze afspraken.

=====Proces stappen=====
*Het systeem van de zorgaanbieder (XIS) levert de beschikbare afspraak slots op basis van de filter criteria uit de persoonlijke gezondheidsomgeving.
*Het systeem van de patiënt (PGO) stuurt een verzoek om een bepaald type afspraak te maken in een bepaalde slot.
*Het systeem van de zorgaanbieder (XIS) ontvangt het afspraakverzoek en geeft een technisch antwoord. Het antwoord geeft aan of het verzoek wel of niet in behandeling genomen kan worden.

Indien een verzoek in behandeling genomen kan worden door XIS, dan kan verwerking enige tijd vergen. Het verzoek wordt niet altijd direct afgehandeld.

Bij een eventueel negatief antwoord van het XIS kan een patiënt ervoor kiezen het opnieuw proberen, bijvoorbeeld met een ander (opnieuw opgevraagd) slot.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een afspraakverzoek.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| AfspraakSlotsRaadplegend
| style="background-color: white;"| EA-1.0.0-ASR-FHIR
| style="background-color: white;"| Raadplegen afspraak slots bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakverzoekSturend
| style="background-color: white;"| EA-1.0.0-AVS-FHIR
| style="background-color: white;"| Sturen afspraakverzoek naar zorgaanbieder
|-
| style="background-color: white;"| AfspraakSlotsBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ASB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak slots
|-
| style="background-color: white;"| AfspraakverzoekOntvangend
| style="background-color: white;"| EA-1.0.0-AVO-FHIR
| style="background-color: white;"| Ontvangen afspraakverzoek van de patient
|-
|}
Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak maken (Totaal).png|Componenten diagram afspraak maken]]

'''Componenten diagram afspraak maken'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakSlots (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="6"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakVerzoek (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraakverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AVS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraakverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AVO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak maken.png|Use case diagram afspraak maken]]

'''Use case diagram afspraak maken

==Use case: Afspraak annuleren door patiënt==
===Doel en relevantie===
Inzicht in afspraken biedt patiënten overzicht en gebruiksgemak. Dat is een functionaliteit die voorwaardelijk is voor deze use case: 'annuleren van afspraken'. Een patiënt is verder geholpen door ook afspraken te kunnen annuleren vanuit een persoonlijke gezondheidsomgeving. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het kunnen annuleren van een afspraak vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn gedefinieerd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
Sturen afspraak annulering
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
Ontvangen afspraak annulering
|}
'''Bedrijfsrollen afspraken inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak annuleren.png|Activiteitendiagram afspraak annuleren]]

'''Activiteitendiagram afspraak annuleren'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het annuleren van afspraken een rol speelt.

<blockquote>Thomas verhuist halverwege oktober 2017 voor zijn afstuderen naar Groningen. De afspraak voor de driemaandelijkse controle was al gemaakt in Rotterdam voor vrijdag 5 januari 2018. Thomas wil nu die afspraak afzeggen omdat hij die dag bezet is vanwege zijn afstudeerstage. Een nieuwe afspraak maakt hij liever in Groningen, dat is voor hem nu veel handiger.
Hij gebruikt zijn PGO om een verzoek te doen de afspraak in Rotterdam te annuleren. Een aantal uren later bevestigt de medisch secretaresse deze annulering. Thomas kan de afspraken weer raadplegen via zijn PGO.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Een persoonlijke gezondheidsomgeving kan achterhalen welk afspraken het verbonden XIS heeft voor de patiënt. Dit betreft het raadplegen van afspraken. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan voor een bestaande afspraak een verzoek doen tot annulering. Een XIS ontvangt, behandelt en beantwoordt een dergelijk verzoek.

Een PGO heeft afspraken geraadpleegd en opvolging verzoek beoordeeld. Mocht het verzoek niet verwerkt zijn, kan een patiënt ervoor kiezen het opnieuw te proberen, of op een andere manier de zorgaanbieder te benaderen. Indien het verzoek verwerkt is, stelt XIS bij raadpleging door PGO de afspraak met status ‘geannuleerd’ beschikbaar.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van informatie over afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil bepaalde afspraken kunnen annuleren en de zorgaanbieder ondersteunt dit.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) raadpleegt de beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Het systeem van de patiënt (PGO) stuurt een verzoek om de bestaande afspraak te annuleren.
*Het systeem van de zorgaanbieder (XIS) ontvangt de annulering en geeft een technisch antwoord. Het antwoord kan positief of negatief zijn voor het doorvoeren van de annulering.
*Het systeem van de patiënt (PGO) raadpleegt de beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken (waaronder de geannuleerde afspraak met status 'geannuleerd') op voor de patiënt.

Indien het verzoek verwerkt kan worden, stelt XIS de afspraak met status 'geannuleerd' beschikbaar, na raadpleging door patiënt vanuit zijn PGO.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een verzoek tot annulering van een afspraak.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="2"| PGO
| style="background-color: white;"| AfsprakenRaadplegend
| style="background-color: white;"| EA-1.0.0-AFR-FHIR
| style="background-color: white;"| Raadplegen afspraken bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakAnnuleringSturend
| style="background-color: white;"| EA-1.0.0-AAS-FHIR
| style="background-color: white;"| Sturen afspraak annulering naar de zorgaanbieder
|-
| style="background-color: white;" rowspan="2"| XIS
| style="background-color: white;"| AfsprakenBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraken aan de patiënt
|-
| style="background-color: white;"| AfspraakAnnuleringOntvangend
| style="background-color: white;"| EA-1.0.0-AAO-FHIR
| style="background-color: white;"| Ontvangen afspraak annulering van de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak annuleren (Totaal).png |Componenten diagram afspraak annuleren]]

'''Componenten diagram afspraak annuleren'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="4"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakAnnulering (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraak annulering
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AAS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraak annulering
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AAO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak annuleren.png |Use case diagram afspraak annuleren]]

'''Use case diagram afspraak annuleren

==Use case: Afspraak wijzigen door patiënt==
===Doel en relevantie===
Inzicht in en het maken van afspraken biedt patiënten overzicht en gebruiksgemak. Dat zijn functionaliteiten die voorwaardelijk zijn voor deze use case: 'wijzigen van afspraken'. Een patiënt is verder geholpen door ook afspraken te kunnen wijzigen vanuit een persoonlijke gezondheidsomgeving. Een wijziging kan ook een annulering betreffen. Dit draagt verder bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het kunnen wijzigen van een afspraak vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn gedefinieerd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak

Raadplegen afspraak slots

Sturen afspraak wijzigingsverzoek
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak

Beschikbaarstellen afspraak slots

Ontvangen afspraak wijzigingsverzoek
|}
'''Bedrijfsrollen afspraken inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak wijzigen.png|Activiteitendiagram afspraak wijzigen]]

'''Activiteitendiagram afspraak wijzigen'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het wijzigen van afspraken een rol speelt.

<blockquote>In de loop van december krijgt Thomas een buitenkansje. Een aantal van zijn vrienden gaan met skivakantie van zaterdag 5 t/m 12 januari en er is een plekje vrijgekomen. Voor een zacht prijsje kan hij mee. Daar heeft hij veel zin in!

Thomas zet de skivakantie ‘s avonds laat in zijn agenda en ziet dat dit conflicteert met zijn controle-afspraak in het Noorderziekenhuis op 10 januari. Hij moet die afspraak gaan verzetten. Het is 23:15 en dus te laat om het ziekenhuis hiervoor direct te bellen.

Via zijn PGO kijkt hij daarom naar beschikbare tijden in de derde week van januari. Er blijkt gelukkig nog een gaatje te zijn op vrijdag 19 januari om 11:30 – 12:30. Het verzoek om te wijzigen gaat via zijn PGO naar het ZIS, dat de ontvangst van het verzoek bevestigt. Bij raadpleging van de afspraken vanuit PGO, stelt XIS de nieuwe afspraak beschikbaar, alsmede de oorspronkelijke afspraak met status ‘ geannuleerd’.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Het systeem van een zorgaanbieder (XIS) stelt afspraken beschikbaar aan het systeem van een patiënt (PGO).
*Een persoonlijke gezondheidsomgeving kan achterhalen welk type afspraken het verbonden XIS ondersteunt: dit betreft het raadplegen van typen afspraken. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan voor een bepaalde periode én een bepaald type afspraak de beschikbare tijden ophalen uit het XIS. Dit betreft het raadplegen van beschikbare afspraak slots. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan - op basis van beschikbare slots - een verzoek tot het wijzigen van een concrete afspraak doen aan het XIS. Een XIS kan een dergelijk afspraak wijzigingsverzoek behandelen en ontvangst van het verzoek bevestigen.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van informatie over afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil een afspraak wijzigen en de zorgaanbieder ondersteunt het wijzigen van afspraken.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om afspraken in te zien en er één te selecteren die hij wil wijzigen.
*Het systeem van de patiënt (PGO) vraagt om beschikbare slots voor een bepaald type afspraak in een bepaalde tijdsperiode bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de beschikbare afspraak slots op basis van de filter criteria uit de persoonlijke gezondheidsomgeving.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om beschikbare slots in te zien en er één te selecteren.
*Het systeem van de patiënt (PGO) stuurt een verzoek om de bestaande afspraak te wijzigen.
*Het systeem van de zorgaanbieder (XIS) ontvangt het afspraak wijzigingsverzoek en geeft een technisch antwoord. Het antwoord kan positief of negatief zijn voor de wijziging.

Patiënt raadpleegt opnieuw de afspraken vanuit zijn PGO + XIS stelt de nieuwe afspraak beschikbaar, alsmede de oorspronkelijke afspraak met status ‘geannuleerd’.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een afspraak wijzigingsverzoek.

Bij een eventueel negatief antwoord van het XIS kan een patiënt ervoor kiezen het opnieuw proberen, bijvoorbeeld met een ander (opnieuw opgevraagd) slot.
Bij een positief antwoord is de afspraak gewijzigd en inzichtelijk in zowel XIS als PGO.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="4"| PGO
| style="background-color: white;"| AfspraakRaadplegend
| style="background-color: white;"| EA-1.0.0-AFO-FHIR
| style="background-color: white;"| Raadplegen afspraak bij zorgaanbieder
|-
| style="background-color: white;"| AfspraakSlotsRaadplegend
| style="background-color: white;"| EA-1.0.0-ASR-FHIR
| style="background-color: white;"| Raadplegen afspraak slots bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakWijzigingsverzoekSturend
| style="background-color: white;"| EA-1.0.0-AWS-FHIR
| style="background-color: white;"| Sturen afspraak wijzigingsverzoek
|-
| style="background-color: white;" rowspan="4"| XIS
| style="background-color: white;"| AfspraakBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak aan de patiënt
|-
| style="background-color: white;"| AfspraakSlotsBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ASB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak slots
|-
| style="background-color: white;"| AfspraakWijzigingsverzoekOntvangend
| style="background-color: white;"| EA-1.0.0-AWO-FHIR
| style="background-color: white;"| Ontvangen afspraak wijzigingsverzoek van de patiënt.
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak wijzigen (Totaal).png|Componenten diagram afspraak wijzigen]]

'''Componenten diagram afspraak wijzigen'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="8"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakSlots (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakWijziging (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraak wijzigingsverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AWS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraak wijzigingsverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AWO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak wijzigen.png|Use case diagram afspraak wijzigen]]

'''Use case diagram afspraak wijzigen

=Functionaliteit=
-

=Verantwoordelijkheid voor informatie=
Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

=Infrastructuur=
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| AUTEUR(S)
| style="background-color: white;"| TITEL
| style="background-color: white;"| VERSIE
| style="background-color: white;"| DATUM
| style="background-color: white;"| BRON
| style="background-color: white;"| ORGANISATIE
|}
'''Referenties

MedMij:V2018.04 OntwerpeAfspraak

2018-08-30T13:07:01Z

Marten Smits:

{{#customtitle:Use Cases eAfspraak, draft version}}
{{IssueBox|Dit is een werkpagina.

De gepubliceerde versie kan hier gevonden worden: https://informatiestandaarden.nictiz.nl/wiki/MedMij:Vcurrent_Ontwerpen}}
[[Bestand:EAfspraak_icoon_zonder_tekst.png |link=|links |87px|eAfspraak]]
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.04_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.04_FHIR_eAfspraak|Tecnical]]
desc none
</imagemap>

<div class="toclimit-{{{2|{{{limit|3}}}}}}">__TOC__</div>

=Inleiding=
Deze pagina beschrijft use cases waarbij een patiënt afspraken kan raadplegen, maken, annuleren of wijzigen met behulp van een persoonlijke gezondheidsomgeving. Algemene informatie betreffende deze use cases kan gevonden worden op deze [https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.04_Ontwerpen wiki pagina].

=Use Cases=
Deze sectie vervolgt met de volgende use cases:
*[[#Use_case:_Afspraak_raadplegen_door_pati.C3.ABnt|Afspraak raadplegen]]
*[[#Use_case:_Afspraak_maken_door_pati.C3.ABnt|Afspraak maken]]
*[[#Use_case:_Afspraak_annuleren_door_pati.C3.ABnt|Afspraak annuleren]]
*[[#Use_case:_Afspraak_wijzigen_door_pati.C3.ABnt|Afspraak wijzigen]]
==Use case: Afspraak raadplegen door patiënt==
===Doel en relevantie===
Inzicht in afspraken biedt patiënten overzicht en gebruiksgemak. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van afspraken vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===

====Raadplegen afspraak ====
Het raadplegen van een afspraak gaat van een specifieke patiënt naar een specifieke organisatie in de zorg (bijvoorbeeld een zorgaanbieder).

Verdere informatie-elementen in de vraag om afspraken zijn:
*periode (startdatum - einddatum) waarin de afspraak plaats heeft gehad / heeft / zal hebben
Dit betreft dus de filtermogelijkheden (query parameters) in de vraag om afspraken.

====Beschikbaarstellen afspraak ====
De informatie-elementen voor beschikbaarstellen afspraak staan in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak]

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil afspraken raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt afspraken beschikbaar
|}
'''Bedrijfsrollen afspraak inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak raadplegen.png|Activiteitendiagram afspraak raadplegen]]

'''Activiteitendiagram afspraak raadplegen'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een aantal voor Thomas relevante situaties waarbij het raadplegen van afspraken een rol speelt.

<blockquote>Thomas heeft iedere drie maanden een controle in het ziekenhuis in verband met zijn Diabetes aandoening. De eerstkomende afspraak is op vrijdag 6 oktober 2017 om 10:30u met internist Janssen bij het Antonius Ziekenhuis in Rotterdam en duurt een uur. Het ziekenhuisinformatiesysteem heeft deze afspraak beschikbaar gemaakt voor de persoonlijke gezondheidsomgeving van Thomas. Thomas kan deze afspraak dan ook inzien via zijn persoonlijke gezondheidsomgeving.
----
Op 6 september belt de afdelingssecretaresse van het ziekenhuis. Zij heeft het verzoek aan Thomas of de afspraak verzet kan worden naar dinsdag 3 oktober om 16:00 uur. Dat komt hem prima uit, dus hij gaat akkoord. Het ziekenhuisinformatiesysteem maakt deze nieuwe afspraakinformatie beschikbaar voor de persoonlijke gezondheidsomgeving. Wanneer Thomas later die dag kijkt, ziet hij ook de bijgewerkte afspraakinformatie in zijn persoonlijke gezondheidsomgeving. Wel zo makkelijk, want hij was het eerder die dag vergeten op te schrijven.
</blockquote>

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het systeem van een zorgaanbieder (XIS) stelt de afspraak beschikbaar aan het systeem van een patiënt (PGO).
Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.
=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

De patiënt wil afspraken inzien en de zorgaanbieder stelt dit ook beschikbaar.
Een patiënt neemt steeds zelf het initiatief om zijn afspraken te raadplegen.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om afspraken in te zien.

=====Post conditie=====
De patiënt heeft afspraken geraadpleegd via de persoonlijke gezondheidsomgeving.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om afspraken van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| AfspraakRaadplegend
| style="background-color: white;"| EA-1.0.0-AFR-FHIR
| style="background-color: white;"| Raadplegen afspraak bij zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| AfspraakBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak aan de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak raadplegen (Totaal).png |Componenten diagram afspraak raadplegen]]

'''Componenten diagram afspraak raadplegen'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak raadplegen.png|Use case diagram afspraak raadplegen]]

'''Use case diagram afspraak raadplegen

==Use case: Afspraak maken door patiënt==
===Doel en relevantie===
Het maken van afspraken via een persoonlijke gezondheidsomgeving biedt patiënten gebruiksgemak. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het elektronisch en gestructureerd afspraken kunnen maken vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn vastgelegd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots

Sturen afspraakverzoek
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots

Ontvangen afspraak verzoek
|}
'''Bedrijfsrollen Afspraak inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak maken.png|Activiteitendiagram afspraak maken]]

'''Activiteitendiagram maken afspraak'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het maken van afspraken een rol speelt.

<blockquote>De persoonlijke gezondheidsomgeving van Thomas en het ziekenhuisinformatiesysteem (ZIS) van het Noorderziekenhuis in Groningen zijn verbonden vanwege een eerder bezoek van Thomas in het ziekenhuis.

Thomas wil een afspraak maken voor de driemaandelijkse controle met een diabetesverpleegkundige. Hij wil dit ergens in de tweede week van januari. Zijn persoonlijke gezondheidsomgeving haalt de beschikbare tijden voor deze afspraak op uit het Groningse ziekenhuisinformatiesysteem. Thomas kiest voor woensdag 10 januari van 14:00 – 15:00 uur. Dit verzoek gaat via zijn persoonlijke gezondheidsomgeving naar het ziekenhuisinformatiesysteem, dat de ontvangst van dit verzoek bevestigt. De afspraak is door Thomas te raadplegen via zijn persoonlijke gezondheidsomgeving.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Een persoonlijke gezondheidsomgeving kan voor een bepaalde periode én een bepaald type afspraak de beschikbare tijden ophalen uit het XIS. Dit betreft het raadplegen van beschikbare afspraak slots. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan - op basis van beschikbare slots - een verzoek tot het maken van een concrete afspraak doen aan het XIS. Een XIS kan een dergelijk afspraakverzoek wel/niet in behandeling nemen en stuurt daarvan een bevestiging.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch maken van afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil bepaalde typen afspraken maken en de zorgaanbieder ondersteunt het maken van deze afspraken.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare slots voor een bepaald type afspraak in een bepaalde tijdsperiode bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de beschikbare afspraak slots op basis van de filter criteria uit de persoonlijke gezondheidsomgeving.
*Het systeem van de patiënt (PGO) stuurt een verzoek om een bepaald type afspraak te maken in een bepaalde slot.
*Het systeem van de zorgaanbieder (XIS) ontvangt het afspraakverzoek en geeft een technisch antwoord. Het antwoord geeft aan of het verzoek wel of niet in behandeling genomen kan worden.

Indien een verzoek in behandeling genomen kan worden door XIS, dan kan verwerking enige tijd vergen. Het verzoek wordt niet altijd direct afgehandeld.

Bij een eventueel negatief antwoord van het XIS kan een patiënt ervoor kiezen het opnieuw proberen, bijvoorbeeld met een ander (opnieuw opgevraagd) slot.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een afspraakverzoek.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| AfspraakSlotsRaadplegend
| style="background-color: white;"| EA-1.0.0-ASR-FHIR
| style="background-color: white;"| Raadplegen afspraak slots bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakverzoekSturend
| style="background-color: white;"| EA-1.0.0-AVS-FHIR
| style="background-color: white;"| Sturen afspraakverzoek naar zorgaanbieder
|-
| style="background-color: white;"| AfspraakSlotsBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ASB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak slots
|-
| style="background-color: white;"| AfspraakverzoekOntvangend
| style="background-color: white;"| EA-1.0.0-AVO-FHIR
| style="background-color: white;"| Ontvangen afspraakverzoek van de patient
|-
|}
Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak maken (Totaal).png|Componenten diagram afspraak maken]]

'''Componenten diagram afspraak maken'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakSlots (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="6"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakVerzoek (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraakverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AVS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraakverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AVO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak maken.png|Use case diagram afspraak maken]]

'''Use case diagram afspraak maken

==Use case: Afspraak annuleren door patiënt==
===Doel en relevantie===
Inzicht in afspraken biedt patiënten overzicht en gebruiksgemak. Dat is een functionaliteit die voorwaardelijk is voor deze use case: 'annuleren van afspraken'. Een patiënt is verder geholpen door ook afspraken te kunnen annuleren vanuit een persoonlijke gezondheidsomgeving. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het kunnen annuleren van een afspraak vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn gedefinieerd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
Sturen afspraak annulering
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
Ontvangen afspraak annulering
|}
'''Bedrijfsrollen afspraken inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak annuleren.png|Activiteitendiagram afspraak annuleren]]

'''Activiteitendiagram afspraak annuleren'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het annuleren van afspraken een rol speelt.

<blockquote>Thomas verhuist halverwege oktober 2017 voor zijn afstuderen naar Groningen. De afspraak voor de driemaandelijkse controle was al gemaakt in Rotterdam voor vrijdag 5 januari 2018. Thomas wil nu die afspraak afzeggen omdat hij die dag bezet is vanwege zijn afstudeerstage. Een nieuwe afspraak maakt hij liever in Groningen, dat is voor hem nu veel handiger.
Hij gebruikt zijn PGO om een verzoek te doen de afspraak in Rotterdam te annuleren. Een aantal uren later bevestigt de medisch secretaresse deze annulering. Thomas kan de afspraken weer raadplegen via zijn PGO.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Een persoonlijke gezondheidsomgeving kan achterhalen welk afspraken het verbonden XIS heeft voor de patiënt. Dit betreft het raadplegen van afspraken. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan voor een bestaande afspraak een verzoek doen tot annulering. Een XIS ontvangt, behandelt en beantwoordt een dergelijk verzoek.

Een PGO heeft afspraken geraadpleegd en opvolging verzoek beoordeeld. Mocht het verzoek niet verwerkt zijn, kan een patiënt ervoor kiezen het opnieuw te proberen, of op een andere manier de zorgaanbieder te benaderen. Indien het verzoek verwerkt is, stelt XIS bij raadpleging door PGO de afspraak met status ‘geannuleerd’ beschikbaar.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van informatie over afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil bepaalde afspraken kunnen annuleren en de zorgaanbieder ondersteunt dit.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) raadpleegt de beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Het systeem van de patiënt (PGO) stuurt een verzoek om de bestaande afspraak te annuleren.
*Het systeem van de zorgaanbieder (XIS) ontvangt de annulering en geeft een technisch antwoord. Het antwoord kan positief of negatief zijn voor het doorvoeren van de annulering.
*Het systeem van de patiënt (PGO) raadpleegt de beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken (waaronder de geannuleerde afspraak met status 'geannuleerd') op voor de patiënt.

Indien het verzoek verwerkt kan worden, stelt XIS de afspraak met status 'geannuleerd' beschikbaar, na raadpleging door patiënt vanuit zijn PGO.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een verzoek tot annulering van een afspraak.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="2"| PGO
| style="background-color: white;"| AfsprakenRaadplegend
| style="background-color: white;"| EA-1.0.0-AFR-FHIR
| style="background-color: white;"| Raadplegen afspraken bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakAnnuleringSturend
| style="background-color: white;"| EA-1.0.0-AAS-FHIR
| style="background-color: white;"| Sturen afspraak annulering naar de zorgaanbieder
|-
| style="background-color: white;" rowspan="2"| XIS
| style="background-color: white;"| AfsprakenBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraken aan de patiënt
|-
| style="background-color: white;"| AfspraakAnnuleringOntvangend
| style="background-color: white;"| EA-1.0.0-AAO-FHIR
| style="background-color: white;"| Ontvangen afspraak annulering van de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak annuleren (Totaal).png |Componenten diagram afspraak annuleren]]

'''Componenten diagram afspraak annuleren'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="4"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakAnnulering (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraak annulering
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AAS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraak annulering
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AAO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak annuleren.png |Use case diagram afspraak annuleren]]

'''Use case diagram afspraak annuleren

==Use case: Afspraak wijzigen door patiënt==
===Doel en relevantie===
Inzicht in en het maken van afspraken biedt patiënten overzicht en gebruiksgemak. Dat zijn functionaliteiten die voorwaardelijk zijn voor deze use case: 'wijzigen van afspraken'. Een patiënt is verder geholpen door ook afspraken te kunnen wijzigen vanuit een persoonlijke gezondheidsomgeving. Een wijziging kan ook een annulering betreffen. Dit draagt verder bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het kunnen wijzigen van een afspraak vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn gedefinieerd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak

Raadplegen afspraak slots

Sturen afspraak wijzigingsverzoek
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak

Beschikbaarstellen afspraak slots

Ontvangen afspraak wijzigingsverzoek
|}
'''Bedrijfsrollen afspraken inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak wijzigen.png|Activiteitendiagram afspraak wijzigen]]

'''Activiteitendiagram afspraak wijzigen'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het wijzigen van afspraken een rol speelt.

<blockquote>In de loop van december krijgt Thomas een buitenkansje. Een aantal van zijn vrienden gaan met skivakantie van zaterdag 5 t/m 12 januari en er is een plekje vrijgekomen. Voor een zacht prijsje kan hij mee. Daar heeft hij veel zin in!

Thomas zet de skivakantie ‘s avonds laat in zijn agenda en ziet dat dit conflicteert met zijn controle-afspraak in het Noorderziekenhuis op 10 januari. Hij moet die afspraak gaan verzetten. Het is 23:15 en dus te laat om het ziekenhuis hiervoor direct te bellen.

Via zijn PGO kijkt hij daarom naar beschikbare tijden in de derde week van januari. Er blijkt gelukkig nog een gaatje te zijn op vrijdag 19 januari om 11:30 – 12:30. Het verzoek om te wijzigen gaat via zijn PGO naar het ZIS, dat de ontvangst van het verzoek bevestigt. Bij raadpleging van de afspraken vanuit PGO, stelt XIS de nieuwe afspraak beschikbaar, alsmede de oorspronkelijke afspraak met status ‘ geannuleerd’.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Het systeem van een zorgaanbieder (XIS) stelt afspraken beschikbaar aan het systeem van een patiënt (PGO).
*Een persoonlijke gezondheidsomgeving kan achterhalen welk type afspraken het verbonden XIS ondersteunt: dit betreft het raadplegen van typen afspraken. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan voor een bepaalde periode én een bepaald type afspraak de beschikbare tijden ophalen uit het XIS. Dit betreft het raadplegen van beschikbare afspraak slots. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan - op basis van beschikbare slots - een verzoek tot het wijzigen van een concrete afspraak doen aan het XIS. Een XIS kan een dergelijk afspraak wijzigingsverzoek behandelen en ontvangst van het verzoek bevestigen.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van informatie over afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil een afspraak wijzigen en de zorgaanbieder ondersteunt het wijzigen van afspraken.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om afspraken in te zien en er één te selecteren die hij wil wijzigen.
*Het systeem van de patiënt (PGO) vraagt om beschikbare slots voor een bepaald type afspraak in een bepaalde tijdsperiode bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de beschikbare afspraak slots op basis van de filter criteria uit de persoonlijke gezondheidsomgeving.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om beschikbare slots in te zien en er één te selecteren.
*Het systeem van de patiënt (PGO) stuurt een verzoek om de bestaande afspraak te wijzigen.
*Het systeem van de zorgaanbieder (XIS) ontvangt het afspraak wijzigingsverzoek en geeft een technisch antwoord. Het antwoord kan positief of negatief zijn voor de wijziging.

Patiënt raadpleegt opnieuw de afspraken vanuit zijn PGO + XIS stelt de nieuwe afspraak beschikbaar, alsmede de oorspronkelijke afspraak met status ‘geannuleerd’.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een afspraak wijzigingsverzoek.

Bij een eventueel negatief antwoord van het XIS kan een patiënt ervoor kiezen het opnieuw proberen, bijvoorbeeld met een ander (opnieuw opgevraagd) slot.
Bij een positief antwoord is de afspraak gewijzigd en inzichtelijk in zowel XIS als PGO.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="4"| PGO
| style="background-color: white;"| AfspraakRaadplegend
| style="background-color: white;"| EA-1.0.0-AFO-FHIR
| style="background-color: white;"| Raadplegen afspraak bij zorgaanbieder
|-
| style="background-color: white;"| AfspraakSlotsRaadplegend
| style="background-color: white;"| EA-1.0.0-ASR-FHIR
| style="background-color: white;"| Raadplegen afspraak slots bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakWijzigingsverzoekSturend
| style="background-color: white;"| EA-1.0.0-AWS-FHIR
| style="background-color: white;"| Sturen afspraak wijzigingsverzoek
|-
| style="background-color: white;" rowspan="4"| XIS
| style="background-color: white;"| AfspraakBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak aan de patiënt
|-
| style="background-color: white;"| AfspraakSlotsBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ASB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak slots
|-
| style="background-color: white;"| AfspraakWijzigingsverzoekOntvangend
| style="background-color: white;"| EA-1.0.0-AWO-FHIR
| style="background-color: white;"| Ontvangen afspraak wijzigingsverzoek van de patiënt.
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak wijzigen (Totaal).png|Componenten diagram afspraak wijzigen]]

'''Componenten diagram afspraak wijzigen'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="8"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakSlots (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakWijziging (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraak wijzigingsverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AWS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraak wijzigingsverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AWO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak wijzigen.png|Use case diagram afspraak wijzigen]]

'''Use case diagram afspraak wijzigen

=Functionaliteit=
-

=Verantwoordelijkheid voor informatie=
Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

=Infrastructuur=
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| AUTEUR(S)
| style="background-color: white;"| TITEL
| style="background-color: white;"| VERSIE
| style="background-color: white;"| DATUM
| style="background-color: white;"| BRON
| style="background-color: white;"| ORGANISATIE
|}
'''Referenties

MedMij:V2018.04 OntwerpeAfspraak

2018-08-30T13:06:23Z

Marten Smits:

{{#customtitle:Use Cases eAfspraak, draft version}}
{{IssueBox|Dit is een werkpagina.

De gepubliceerde versie kan hier gevonden worden: https://informatiestandaarden.nictiz.nl/wiki/MedMij:Vcurrent_Ontwerpen}}
[[Bestand:EAfspraak_icoon_zonder_tekst.png |link=|links |87px|eAfspraak]]
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.04_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.04_FHIR_eAfspraak|Tecnical]]
desc none
</imagemap>

<div class="toclimit-{{{2|{{{limit|3}}}}}}">__TOC__</div>

=Inleiding=
Deze pagina beschrijft use cases waarbij een patiënt afspraken kan raadplegen, maken, annuleren of wijzigen met behulp van een persoonlijke gezondheidsomgeving. Algemene informatie betreffende deze use cases kan gevonden worden op deze [https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.04_Ontwerpen wiki pagina].

=Use Cases=
Deze sectie vervolgt met de volgende use cases:
*[[#Use_case:_Afspraak_raadplegen_door_pati.C3.ABnt|Afspraak raadplegen]]
*[[#Use_case:_Afspraak_maken_door_pati.C3.ABnt|Afspraak maken]]
*[[#Use_case:_Afspraak_annuleren_door_pati.C3.ABnt|Afspraak annuleren]]
*[[#Use_case:_Afspraak_wijzigen_door_pati.C3.ABnt|Afspraak wijzigen]]
==Use case: Afspraak raadplegen door patiënt==
===Doel en relevantie===
Inzicht in afspraken biedt patiënten overzicht en gebruiksgemak. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van afspraken vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===

====Raadplegen afspraak ====
Het raadplegen van een afspraak gaat van een specifieke patiënt naar een specifieke organisatie in de zorg (bijvoorbeeld een zorgaanbieder).

Verdere informatie-elementen in de vraag om afspraken zijn:
*periode (startdatum - einddatum) waarin de afspraak plaats heeft gehad / heeft / zal hebben
Dit betreft dus de filtermogelijkheden (query parameters) in de vraag om afspraken.

====Beschikbaarstellen afspraak ====
De informatie-elementen voor beschikbaarstellen afspraak staan in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak]

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil afspraken raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt afspraken beschikbaar
|}
'''Bedrijfsrollen afspraak inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak raadplegen.png|Activiteitendiagram afspraak raadplegen]]

'''Activiteitendiagram afspraak raadplegen'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een aantal voor Thomas relevante situaties waarbij het raadplegen van afspraken een rol speelt.

<blockquote>Thomas heeft iedere drie maanden een controle in het ziekenhuis in verband met zijn Diabetes aandoening. De eerstkomende afspraak is op vrijdag 6 oktober 2017 om 10:30u met internist Janssen bij het Antonius Ziekenhuis in Rotterdam en duurt een uur. Het ziekenhuisinformatiesysteem heeft deze afspraak beschikbaar gemaakt voor de persoonlijke gezondheidsomgeving van Thomas. Thomas kan deze afspraak dan ook inzien via zijn persoonlijke gezondheidsomgeving.
----
Op 6 september belt de afdelingssecretaresse van het ziekenhuis. Zij heeft het verzoek aan Thomas of de afspraak verzet kan worden naar dinsdag 3 oktober om 16:00 uur. Dat komt hem prima uit, dus hij gaat akkoord. Het ziekenhuisinformatiesysteem maakt deze nieuwe afspraakinformatie beschikbaar voor de persoonlijke gezondheidsomgeving. Wanneer Thomas later die dag kijkt, ziet hij ook de bijgewerkte afspraakinformatie in zijn persoonlijke gezondheidsomgeving. Wel zo makkelijk, want hij was het eerder die dag vergeten op te schrijven.
</blockquote>

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het systeem van een zorgaanbieder (XIS) stelt de afspraak beschikbaar aan het systeem van een patiënt (PGO).
Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.
=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

De patiënt wil afspraken inzien en de zorgaanbieder stelt dit ook beschikbaar.
Een patiënt neemt steeds zelf het initiatief om zijn afspraken te raadplegen.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om afspraken in te zien.

=====Post conditie=====
De patiënt heeft afspraken geraadpleegd via de persoonlijke gezondheidsomgeving.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om afspraken van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| AfspraakRaadplegend
| style="background-color: white;"| EA-1.0.0-AFR-FHIR
| style="background-color: white;"| Raadplegen afspraak bij zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| AfspraakBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak aan de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak raadplegen (Totaal).png |Componenten diagram afspraak raadplegen]]

'''Componenten diagram afspraak raadplegen'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak raadplegen.png|Use case diagram afspraak raadplegen]]

'''Use case diagram afspraak raadplegen

==Use case: Afspraak maken door patiënt==
===Doel en relevantie===
Het maken van afspraken via een persoonlijke gezondheidsomgeving biedt patiënten gebruiksgemak. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het elektronisch en gestructureerd afspraken kunnen maken vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn vastgelegd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots

Sturen afspraakverzoek
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots

Ontvangen afspraak verzoek
|}
'''Bedrijfsrollen Afspraak inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak maken.png|Activiteitendiagram afspraak maken]]

'''Activiteitendiagram maken afspraak'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het maken van afspraken een rol speelt.

<blockquote>De persoonlijke gezondheidsomgeving van Thomas en het ziekenhuisinformatiesysteem (ZIS) van het Noorderziekenhuis in Groningen zijn verbonden vanwege een eerder bezoek van Thomas in het ziekenhuis.

Thomas wil een afspraak maken voor de driemaandelijkse controle met een diabetesverpleegkundige. Hij wil dit ergens in de tweede week van januari. Zijn persoonlijke gezondheidsomgeving haalt de beschikbare tijden voor deze afspraak op uit het Groningse ziekenhuisinformatiesysteem. Thomas kiest voor woensdag 10 januari van 14:00 – 15:00 uur. Dit verzoek gaat via zijn persoonlijke gezondheidsomgeving naar het ziekenhuisinformatiesysteem, dat de ontvangst van dit verzoek bevestigt. De afspraak is door Thomas te raadplegen via zijn persoonlijke gezondheidsomgeving.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Een persoonlijke gezondheidsomgeving kan voor een bepaalde periode én een bepaald type afspraak de beschikbare tijden ophalen uit het XIS. Dit betreft het raadplegen van beschikbare afspraak slots. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan - op basis van beschikbare slots - een verzoek tot het maken van een concrete afspraak doen aan het XIS. Een XIS kan een dergelijk afspraakverzoek wel/niet in behandeling nemen en stuurt daarvan een bevestiging.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch maken van afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil bepaalde typen afspraken maken en de zorgaanbieder ondersteunt het maken van deze afspraken.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare slots voor een bepaald type afspraak in een bepaalde tijdsperiode bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de beschikbare afspraak slots op basis van de filter criteria uit de persoonlijke gezondheidsomgeving.
*Het systeem van de patiënt (PGO) stuurt een verzoek om een bepaald type afspraak te maken in een bepaalde slot.
*Het systeem van de zorgaanbieder (XIS) ontvangt het afspraakverzoek en geeft een technisch antwoord. Het antwoord geeft aan of het verzoek wel of niet in behandeling genomen kan worden.

Indien een verzoek in behandeling genomen kan worden door XIS, dan kan verwerking enige tijd vergen. Het verzoek wordt niet altijd direct afgehandeld.

Bij een eventueel negatief antwoord van het XIS kan een patiënt ervoor kiezen het opnieuw proberen, bijvoorbeeld met een ander (opnieuw opgevraagd) slot.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een afspraakverzoek.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| AfspraakSlotsRaadplegend
| style="background-color: white;"| EA-1.0.0-ASR-FHIR
| style="background-color: white;"| Raadplegen afspraak slots bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakverzoekSturend
| style="background-color: white;"| EA-1.0.0-AVS-FHIR
| style="background-color: white;"| Sturen afspraakverzoek naar zorgaanbieder
|-
| style="background-color: white;"| AfspraakSlotsBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ASB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak slots
|-
| style="background-color: white;"| AfspraakverzoekOntvangend
| style="background-color: white;"| EA-1.0.0-AVO-FHIR
| style="background-color: white;"| Ontvangen afspraakverzoek van de patient
|-
|}
Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak maken (Totaal).png|Componenten diagram afspraak maken]]

'''Componenten diagram afspraak maken'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakSlots (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="6"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakVerzoek (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraakverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AVS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraakverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AVO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak maken.png|Use case diagram afspraak maken]]

'''Use case diagram afspraak maken

==Use case: Afspraak annuleren door patiënt==
===Doel en relevantie===
Inzicht in afspraken biedt patiënten overzicht en gebruiksgemak. Dat is een functionaliteit die voorwaardelijk is voor deze use case: 'annuleren van afspraken'. Een patiënt is verder geholpen door ook afspraken te kunnen annuleren vanuit een persoonlijke gezondheidsomgeving. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het kunnen annuleren van een afspraak vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn gedefinieerd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
Sturen afspraak annulering
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
Ontvangen afspraak annulering
|}
'''Bedrijfsrollen afspraken inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak annuleren.png|Activiteitendiagram afspraak annuleren]]

'''Activiteitendiagram afspraak annuleren'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het annuleren van afspraken een rol speelt.

<blockquote>Thomas verhuist halverwege oktober 2017 voor zijn afstuderen naar Groningen. De afspraak voor de driemaandelijkse controle was al gemaakt in Rotterdam voor vrijdag 5 januari 2018. Thomas wil nu die afspraak afzeggen omdat hij die dag bezet is vanwege zijn afstudeerstage. Een nieuwe afspraak maakt hij liever in Groningen, dat is voor hem nu veel handiger.
Hij gebruikt zijn PGO om een verzoek te doen de afspraak in Rotterdam te annuleren. Een aantal uren later bevestigt de medisch secretaresse deze annulering. Thomas kan de afspraken weer raadplegen via zijn PGO.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Een persoonlijke gezondheidsomgeving kan achterhalen welk afspraken het verbonden XIS heeft voor de patiënt. Dit betreft het raadplegen van afspraken. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan voor een bestaande afspraak een verzoek doen tot annulering. Een XIS ontvangt, behandelt en beantwoordt een dergelijk verzoek.

Een PGO heeft afspraken geraadpleegd en opvolging verzoek beoordeeld. Mocht het verzoek niet verwerkt zijn, kan een patiënt ervoor kiezen het opnieuw te proberen, of op een andere manier de zorgaanbieder te benaderen. Indien het verzoek verwerkt is, stelt XIS bij raadpleging door PGO de afspraak met status ‘geannuleerd’ beschikbaar.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van informatie over afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil bepaalde afspraken kunnen annuleren en de zorgaanbieder ondersteunt dit.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) raadpleegt de beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Het systeem van de patiënt (PGO) stuurt een verzoek om de bestaande afspraak te annuleren.
*Het systeem van de zorgaanbieder (XIS) ontvangt de annulering en geeft een technisch antwoord. Het antwoord kan positief of negatief zijn voor het doorvoeren van de annulering.
*Het systeem van de patiënt (PGO) raadpleegt de beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken (waaronder de geannuleerde afspraak met status 'geannuleerd') op voor de patiënt.

Indien het verzoek verwerkt kan worden, stelt XIS de afspraak met status 'geannuleerd' beschikbaar, na raadpleging door patiënt vanuit zijn PGO.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een verzoek tot annulering van een afspraak.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="2"| PGO
| style="background-color: white;"| AfsprakenRaadplegend
| style="background-color: white;"| EA-1.0.0-AFR-FHIR
| style="background-color: white;"| Raadplegen afspraken bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakAnnuleringSturend
| style="background-color: white;"| EA-1.0.0-AAS-FHIR
| style="background-color: white;"| Sturen afspraak annulering naar de zorgaanbieder
|-
| style="background-color: white;" rowspan="2"| XIS
| style="background-color: white;"| AfsprakenBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraken aan de patiënt
|-
| style="background-color: white;"| AfspraakAnnuleringOntvangend
| style="background-color: white;"| EA-1.0.0-AAO-FHIR
| style="background-color: white;"| Ontvangen afspraak annulering van de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak annuleren (Totaal).png |Componenten diagram afspraak annuleren]]

'''Componenten diagram afspraak annuleren'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="4"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakAnnulering (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraak annulering
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AAS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraak annulering
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AAO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak annuleren.png |Use case diagram afspraak annuleren]]

'''Use case diagram afspraak annuleren

==Use case: Afspraak wijzigen door patiënt==
===Doel en relevantie===
Inzicht in en het maken van afspraken biedt patiënten overzicht en gebruiksgemak. Dat zijn functionaliteiten die voorwaardelijk zijn voor deze use case: 'wijzigen van afspraken'. Een patiënt is verder geholpen door ook afspraken te kunnen wijzigen vanuit een persoonlijke gezondheidsomgeving. Een wijziging kan ook een annulering betreffen. Dit draagt verder bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het kunnen wijzigen van een afspraak vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn gedefinieerd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak

Raadplegen afspraak slots

Sturen afspraak wijzigingsverzoek
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak

Beschikbaarstellen afspraak slots

Ontvangen afspraak wijzigingsverzoek
|}
'''Bedrijfsrollen afspraken inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak wijzigen.png|Activiteitendiagram afspraak wijzigen]]

'''Activiteitendiagram afspraak wijzigen'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het wijzigen van afspraken een rol speelt.

<blockquote>In de loop van december krijgt Thomas een buitenkansje. Een aantal van zijn vrienden gaan met skivakantie van zaterdag 5 t/m 12 januari en er is een plekje vrijgekomen. Voor een zacht prijsje kan hij mee. Daar heeft hij veel zin in!

Thomas zet de skivakantie ‘s avonds laat in zijn agenda en ziet dat dit conflicteert met zijn controle-afspraak in het Noorderziekenhuis op 10 januari. Hij moet die afspraak gaan verzetten. Het is 23:15 en dus te laat om het ziekenhuis hiervoor direct te bellen.

Via zijn PGO kijkt hij daarom naar beschikbare tijden in de derde week van januari. Er blijkt gelukkig nog een gaatje te zijn op vrijdag 19 januari om 11:30 – 12:30. Het verzoek om te wijzigen gaat via zijn PGO naar het ZIS, dat de ontvangst van het verzoek bevestigt. Bij raadpleging van de afspraken vanuit PGO, stelt XIS de nieuwe afspraak beschikbaar, alsmede de oorspronkelijke afspraak met status ‘ geannuleerd’.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Het systeem van een zorgaanbieder (XIS) stelt afspraken beschikbaar aan het systeem van een patiënt (PGO).
*Een persoonlijke gezondheidsomgeving kan achterhalen welk type afspraken het verbonden XIS ondersteunt: dit betreft het raadplegen van typen afspraken. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan voor een bepaalde periode én een bepaald type afspraak de beschikbare tijden ophalen uit het XIS. Dit betreft het raadplegen van beschikbare afspraak slots. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan - op basis van beschikbare slots - een verzoek tot het wijzigen van een concrete afspraak doen aan het XIS. Een XIS kan een dergelijk afspraak wijzigingsverzoek behandelen en ontvangst van het verzoek bevestigen.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van informatie over afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil een afspraak wijzigen en de zorgaanbieder ondersteunt het wijzigen van afspraken.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om afspraken in te zien en er één te selecteren die hij wil wijzigen.
*Het systeem van de patiënt (PGO) vraagt om beschikbare slots voor een bepaald type afspraak in een bepaalde tijdsperiode bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de beschikbare afspraak slots op basis van de filter criteria uit de persoonlijke gezondheidsomgeving.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om beschikbare slots in te zien en er één te selecteren.
*Het systeem van de patiënt (PGO) stuurt een verzoek om de bestaande afspraak te wijzigen.
*Het systeem van de zorgaanbieder (XIS) ontvangt het afspraak wijzigingsverzoek en geeft een technisch antwoord. Het antwoord kan positief of negatief zijn voor de wijziging.

Patiënt raadpleegt opnieuw de afspraken vanuit zijn PGO + XIS stelt de nieuwe afspraak beschikbaar, alsmede de oorspronkelijke afspraak met status ‘geannuleerd’.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een afspraak wijzigingsverzoek.

Bij een eventueel negatief antwoord van het XIS kan een patiënt ervoor kiezen het opnieuw proberen, bijvoorbeeld met een ander (opnieuw opgevraagd) slot.
Bij een positief antwoord is de afspraak gewijzigd en inzichtelijk in zowel XIS als PGO.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="4"| PGO
| style="background-color: white;"| AfspraakRaadplegend
| style="background-color: white;"| EA-1.0.0-AFO-FHIR
| style="background-color: white;"| Raadplegen afspraak bij zorgaanbieder
|-
| style="background-color: white;"| AfspraakTypenRaadplegend
| style="background-color: white;"| EA-1.0.0-ATR-FHIR
| style="background-color: white;"| Raadplegen afspraak typen bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakSlotsRaadplegend
| style="background-color: white;"| EA-1.0.0-ASR-FHIR
| style="background-color: white;"| Raadplegen afspraak slots bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakWijzigingsverzoekSturend
| style="background-color: white;"| EA-1.0.0-AWS-FHIR
| style="background-color: white;"| Sturen afspraak wijzigingsverzoek
|-
| style="background-color: white;" rowspan="4"| XIS
| style="background-color: white;"| AfspraakBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak aan de patiënt
|-
| style="background-color: white;"| AfspraakTypenBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ATB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak typen
|-
| style="background-color: white;"| AfspraakSlotsBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ASB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak slots
|-
| style="background-color: white;"| AfspraakWijzigingsverzoekOntvangend
| style="background-color: white;"| EA-1.0.0-AWO-FHIR
| style="background-color: white;"| Ontvangen afspraak wijzigingsverzoek van de patiënt.
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak wijzigen (Totaal).png|Componenten diagram afspraak wijzigen]]

'''Componenten diagram afspraak wijzigen'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="8"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakSlots (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakWijziging (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraak wijzigingsverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AWS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraak wijzigingsverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AWO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak wijzigen.png|Use case diagram afspraak wijzigen]]

'''Use case diagram afspraak wijzigen

=Functionaliteit=
-

=Verantwoordelijkheid voor informatie=
Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

=Infrastructuur=
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| AUTEUR(S)
| style="background-color: white;"| TITEL
| style="background-color: white;"| VERSIE
| style="background-color: white;"| DATUM
| style="background-color: white;"| BRON
| style="background-color: white;"| ORGANISATIE
|}
'''Referenties

MedMij:V2018.04 OntwerpeAfspraak

2018-08-30T13:05:52Z

Marten Smits:

{{#customtitle:Use Cases eAfspraak, draft version}}
{{IssueBox|Dit is een werkpagina.

De gepubliceerde versie kan hier gevonden worden: https://informatiestandaarden.nictiz.nl/wiki/MedMij:Vcurrent_Ontwerpen}}
[[Bestand:EAfspraak_icoon_zonder_tekst.png |link=|links |87px|eAfspraak]]
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.04_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.04_FHIR_eAfspraak|Tecnical]]
desc none
</imagemap>

<div class="toclimit-{{{2|{{{limit|3}}}}}}">__TOC__</div>

=Inleiding=
Deze pagina beschrijft use cases waarbij een patiënt afspraken kan raadplegen, maken, annuleren of wijzigen met behulp van een persoonlijke gezondheidsomgeving. Algemene informatie betreffende deze use cases kan gevonden worden op deze [https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.04_Ontwerpen wiki pagina].

=Use Cases=
Deze sectie vervolgt met de volgende use cases:
*[[#Use_case:_Afspraak_raadplegen_door_pati.C3.ABnt|Afspraak raadplegen]]
*[[#Use_case:_Afspraak_maken_door_pati.C3.ABnt|Afspraak maken]]
*[[#Use_case:_Afspraak_annuleren_door_pati.C3.ABnt|Afspraak annuleren]]
*[[#Use_case:_Afspraak_wijzigen_door_pati.C3.ABnt|Afspraak wijzigen]]
==Use case: Afspraak raadplegen door patiënt==
===Doel en relevantie===
Inzicht in afspraken biedt patiënten overzicht en gebruiksgemak. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van afspraken vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===

====Raadplegen afspraak ====
Het raadplegen van een afspraak gaat van een specifieke patiënt naar een specifieke organisatie in de zorg (bijvoorbeeld een zorgaanbieder).

Verdere informatie-elementen in de vraag om afspraken zijn:
*periode (startdatum - einddatum) waarin de afspraak plaats heeft gehad / heeft / zal hebben
Dit betreft dus de filtermogelijkheden (query parameters) in de vraag om afspraken.

====Beschikbaarstellen afspraak ====
De informatie-elementen voor beschikbaarstellen afspraak staan in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak]

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil afspraken raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt afspraken beschikbaar
|}
'''Bedrijfsrollen afspraak inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak raadplegen.png|Activiteitendiagram afspraak raadplegen]]

'''Activiteitendiagram afspraak raadplegen'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een aantal voor Thomas relevante situaties waarbij het raadplegen van afspraken een rol speelt.

<blockquote>Thomas heeft iedere drie maanden een controle in het ziekenhuis in verband met zijn Diabetes aandoening. De eerstkomende afspraak is op vrijdag 6 oktober 2017 om 10:30u met internist Janssen bij het Antonius Ziekenhuis in Rotterdam en duurt een uur. Het ziekenhuisinformatiesysteem heeft deze afspraak beschikbaar gemaakt voor de persoonlijke gezondheidsomgeving van Thomas. Thomas kan deze afspraak dan ook inzien via zijn persoonlijke gezondheidsomgeving.
----
Op 6 september belt de afdelingssecretaresse van het ziekenhuis. Zij heeft het verzoek aan Thomas of de afspraak verzet kan worden naar dinsdag 3 oktober om 16:00 uur. Dat komt hem prima uit, dus hij gaat akkoord. Het ziekenhuisinformatiesysteem maakt deze nieuwe afspraakinformatie beschikbaar voor de persoonlijke gezondheidsomgeving. Wanneer Thomas later die dag kijkt, ziet hij ook de bijgewerkte afspraakinformatie in zijn persoonlijke gezondheidsomgeving. Wel zo makkelijk, want hij was het eerder die dag vergeten op te schrijven.
</blockquote>

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het systeem van een zorgaanbieder (XIS) stelt de afspraak beschikbaar aan het systeem van een patiënt (PGO).
Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.
=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

De patiënt wil afspraken inzien en de zorgaanbieder stelt dit ook beschikbaar.
Een patiënt neemt steeds zelf het initiatief om zijn afspraken te raadplegen.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om afspraken in te zien.

=====Post conditie=====
De patiënt heeft afspraken geraadpleegd via de persoonlijke gezondheidsomgeving.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om afspraken van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| AfspraakRaadplegend
| style="background-color: white;"| EA-1.0.0-AFR-FHIR
| style="background-color: white;"| Raadplegen afspraak bij zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| AfspraakBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak aan de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak raadplegen (Totaal).png |Componenten diagram afspraak raadplegen]]

'''Componenten diagram afspraak raadplegen'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak raadplegen.png|Use case diagram afspraak raadplegen]]

'''Use case diagram afspraak raadplegen

==Use case: Afspraak maken door patiënt==
===Doel en relevantie===
Het maken van afspraken via een persoonlijke gezondheidsomgeving biedt patiënten gebruiksgemak. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het elektronisch en gestructureerd afspraken kunnen maken vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn vastgelegd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots

Sturen afspraakverzoek
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots

Ontvangen afspraak verzoek
|}
'''Bedrijfsrollen Afspraak inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak maken.png|Activiteitendiagram afspraak maken]]

'''Activiteitendiagram maken afspraak'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het maken van afspraken een rol speelt.

<blockquote>De persoonlijke gezondheidsomgeving van Thomas en het ziekenhuisinformatiesysteem (ZIS) van het Noorderziekenhuis in Groningen zijn verbonden vanwege een eerder bezoek van Thomas in het ziekenhuis.

Thomas wil een afspraak maken voor de driemaandelijkse controle met een diabetesverpleegkundige. Hij wil dit ergens in de tweede week van januari. Zijn persoonlijke gezondheidsomgeving haalt de beschikbare tijden voor deze afspraak op uit het Groningse ziekenhuisinformatiesysteem. Thomas kiest voor woensdag 10 januari van 14:00 – 15:00 uur. Dit verzoek gaat via zijn persoonlijke gezondheidsomgeving naar het ziekenhuisinformatiesysteem, dat de ontvangst van dit verzoek bevestigt. De afspraak is door Thomas te raadplegen via zijn persoonlijke gezondheidsomgeving.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Een persoonlijke gezondheidsomgeving kan voor een bepaalde periode én een bepaald type afspraak de beschikbare tijden ophalen uit het XIS. Dit betreft het raadplegen van beschikbare afspraak slots. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan - op basis van beschikbare slots - een verzoek tot het maken van een concrete afspraak doen aan het XIS. Een XIS kan een dergelijk afspraakverzoek wel/niet in behandeling nemen en stuurt daarvan een bevestiging.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch maken van afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil bepaalde typen afspraken maken en de zorgaanbieder ondersteunt het maken van deze afspraken.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare slots voor een bepaald type afspraak in een bepaalde tijdsperiode bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de beschikbare afspraak slots op basis van de filter criteria uit de persoonlijke gezondheidsomgeving.
*Het systeem van de patiënt (PGO) stuurt een verzoek om een bepaald type afspraak te maken in een bepaalde slot.
*Het systeem van de zorgaanbieder (XIS) ontvangt het afspraakverzoek en geeft een technisch antwoord. Het antwoord geeft aan of het verzoek wel of niet in behandeling genomen kan worden.

Indien een verzoek in behandeling genomen kan worden door XIS, dan kan verwerking enige tijd vergen. Het verzoek wordt niet altijd direct afgehandeld.

Bij een eventueel negatief antwoord van het XIS kan een patiënt ervoor kiezen het opnieuw proberen, bijvoorbeeld met een ander (opnieuw opgevraagd) slot.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een afspraakverzoek.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| AfspraakSlotsRaadplegend
| style="background-color: white;"| EA-1.0.0-ASR-FHIR
| style="background-color: white;"| Raadplegen afspraak slots bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakverzoekSturend
| style="background-color: white;"| EA-1.0.0-AVS-FHIR
| style="background-color: white;"| Sturen afspraakverzoek naar zorgaanbieder
|-
| style="background-color: white;"| AfspraakSlotsBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ASB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak slots
|-
| style="background-color: white;"| AfspraakverzoekOntvangend
| style="background-color: white;"| EA-1.0.0-AVO-FHIR
| style="background-color: white;"| Ontvangen afspraakverzoek van de patient
|-
|}
Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak maken (Totaal).png|Componenten diagram afspraak maken]]

'''Componenten diagram afspraak maken'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakSlots (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="6"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakVerzoek (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraakverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AVS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraakverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AVO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak maken.png|Use case diagram afspraak maken]]

'''Use case diagram afspraak maken

==Use case: Afspraak annuleren door patiënt==
===Doel en relevantie===
Inzicht in afspraken biedt patiënten overzicht en gebruiksgemak. Dat is een functionaliteit die voorwaardelijk is voor deze use case: 'annuleren van afspraken'. Een patiënt is verder geholpen door ook afspraken te kunnen annuleren vanuit een persoonlijke gezondheidsomgeving. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het kunnen annuleren van een afspraak vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn gedefinieerd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
Sturen afspraak annulering
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
Ontvangen afspraak annulering
|}
'''Bedrijfsrollen afspraken inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak annuleren.png|Activiteitendiagram afspraak annuleren]]

'''Activiteitendiagram afspraak annuleren'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het annuleren van afspraken een rol speelt.

<blockquote>Thomas verhuist halverwege oktober 2017 voor zijn afstuderen naar Groningen. De afspraak voor de driemaandelijkse controle was al gemaakt in Rotterdam voor vrijdag 5 januari 2018. Thomas wil nu die afspraak afzeggen omdat hij die dag bezet is vanwege zijn afstudeerstage. Een nieuwe afspraak maakt hij liever in Groningen, dat is voor hem nu veel handiger.
Hij gebruikt zijn PGO om een verzoek te doen de afspraak in Rotterdam te annuleren. Een aantal uren later bevestigt de medisch secretaresse deze annulering. Thomas kan de afspraken weer raadplegen via zijn PGO.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Een persoonlijke gezondheidsomgeving kan achterhalen welk afspraken het verbonden XIS heeft voor de patiënt. Dit betreft het raadplegen van afspraken. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan voor een bestaande afspraak een verzoek doen tot annulering. Een XIS ontvangt, behandelt en beantwoordt een dergelijk verzoek.

Een PGO heeft afspraken geraadpleegd en opvolging verzoek beoordeeld. Mocht het verzoek niet verwerkt zijn, kan een patiënt ervoor kiezen het opnieuw te proberen, of op een andere manier de zorgaanbieder te benaderen. Indien het verzoek verwerkt is, stelt XIS bij raadpleging door PGO de afspraak met status ‘geannuleerd’ beschikbaar.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van informatie over afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil bepaalde afspraken kunnen annuleren en de zorgaanbieder ondersteunt dit.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) raadpleegt de beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Het systeem van de patiënt (PGO) stuurt een verzoek om de bestaande afspraak te annuleren.
*Het systeem van de zorgaanbieder (XIS) ontvangt de annulering en geeft een technisch antwoord. Het antwoord kan positief of negatief zijn voor het doorvoeren van de annulering.
*Het systeem van de patiënt (PGO) raadpleegt de beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken (waaronder de geannuleerde afspraak met status 'geannuleerd') op voor de patiënt.

Indien het verzoek verwerkt kan worden, stelt XIS de afspraak met status 'geannuleerd' beschikbaar, na raadpleging door patiënt vanuit zijn PGO.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een verzoek tot annulering van een afspraak.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="2"| PGO
| style="background-color: white;"| AfsprakenRaadplegend
| style="background-color: white;"| EA-1.0.0-AFR-FHIR
| style="background-color: white;"| Raadplegen afspraken bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakAnnuleringSturend
| style="background-color: white;"| EA-1.0.0-AAS-FHIR
| style="background-color: white;"| Sturen afspraak annulering naar de zorgaanbieder
|-
| style="background-color: white;" rowspan="2"| XIS
| style="background-color: white;"| AfsprakenBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraken aan de patiënt
|-
| style="background-color: white;"| AfspraakAnnuleringOntvangend
| style="background-color: white;"| EA-1.0.0-AAO-FHIR
| style="background-color: white;"| Ontvangen afspraak annulering van de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak annuleren (Totaal).png |Componenten diagram afspraak annuleren]]

'''Componenten diagram afspraak annuleren'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="4"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakAnnulering (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraak annulering
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AAS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraak annulering
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AAO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak annuleren.png |Use case diagram afspraak annuleren]]

'''Use case diagram afspraak annuleren

==Use case: Afspraak wijzigen door patiënt==
===Doel en relevantie===
Inzicht in en het maken van afspraken biedt patiënten overzicht en gebruiksgemak. Dat zijn functionaliteiten die voorwaardelijk zijn voor deze use case: 'wijzigen van afspraken'. Een patiënt is verder geholpen door ook afspraken te kunnen wijzigen vanuit een persoonlijke gezondheidsomgeving. Een wijziging kan ook een annulering betreffen. Dit draagt verder bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het kunnen wijzigen van een afspraak vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn gedefinieerd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak

Raadplegen afspraak slots

Sturen afspraak wijzigingsverzoek
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak

Beschikbaarstellen afspraak slots

Ontvangen afspraak wijzigingsverzoek
|}
'''Bedrijfsrollen afspraken inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak wijzigen.png|Activiteitendiagram afspraak wijzigen]]

'''Activiteitendiagram afspraak wijzigen'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het wijzigen van afspraken een rol speelt.

<blockquote>In de loop van december krijgt Thomas een buitenkansje. Een aantal van zijn vrienden gaan met skivakantie van zaterdag 5 t/m 12 januari en er is een plekje vrijgekomen. Voor een zacht prijsje kan hij mee. Daar heeft hij veel zin in!

Thomas zet de skivakantie ‘s avonds laat in zijn agenda en ziet dat dit conflicteert met zijn controle-afspraak in het Noorderziekenhuis op 10 januari. Hij moet die afspraak gaan verzetten. Het is 23:15 en dus te laat om het ziekenhuis hiervoor direct te bellen.

Via zijn PGO kijkt hij daarom naar beschikbare tijden in de derde week van januari. Er blijkt gelukkig nog een gaatje te zijn op vrijdag 19 januari om 11:30 – 12:30. Het verzoek om te wijzigen gaat via zijn PGO naar het ZIS, dat de ontvangst van het verzoek bevestigt. Bij raadpleging van de afspraken vanuit PGO, stelt XIS de nieuwe afspraak beschikbaar, alsmede de oorspronkelijke afspraak met status ‘ geannuleerd’.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Het systeem van een zorgaanbieder (XIS) stelt afspraken beschikbaar aan het systeem van een patiënt (PGO).
*Een persoonlijke gezondheidsomgeving kan achterhalen welk type afspraken het verbonden XIS ondersteunt: dit betreft het raadplegen van typen afspraken. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan voor een bepaalde periode én een bepaald type afspraak de beschikbare tijden ophalen uit het XIS. Dit betreft het raadplegen van beschikbare afspraak slots. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan - op basis van beschikbare slots - een verzoek tot het wijzigen van een concrete afspraak doen aan het XIS. Een XIS kan een dergelijk afspraak wijzigingsverzoek behandelen en ontvangst van het verzoek bevestigen.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van informatie over afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil een afspraak wijzigen en de zorgaanbieder ondersteunt het wijzigen van afspraken.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om afspraken in te zien en er één te selecteren die hij wil wijzigen.
*Het systeem van de patiënt (PGO) vraagt om beschikbare slots voor een bepaald type afspraak in een bepaalde tijdsperiode bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de beschikbare afspraak slots op basis van de filter criteria uit de persoonlijke gezondheidsomgeving.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om beschikbare slots in te zien en er één te selecteren.
*Het systeem van de patiënt (PGO) stuurt een verzoek om de bestaande afspraak te wijzigen.
*Het systeem van de zorgaanbieder (XIS) ontvangt het afspraak wijzigingsverzoek en geeft een technisch antwoord. Het antwoord kan positief of negatief zijn voor de wijziging.

Patiënt raadpleegt opnieuw de afspraken vanuit zijn PGO + XIS stelt de nieuwe afspraak beschikbaar, alsmede de oorspronkelijke afspraak met status ‘geannuleerd’.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een afspraak wijzigingsverzoek.

Bij een eventueel negatief antwoord van het XIS kan een patiënt ervoor kiezen het opnieuw proberen, bijvoorbeeld met een ander (opnieuw opgevraagd) slot.
Bij een positief antwoord is de afspraak gewijzigd en inzichtelijk in zowel XIS als PGO.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="4"| PGO
| style="background-color: white;"| AfspraakRaadplegend
| style="background-color: white;"| EA-1.0.0-AFO-FHIR
| style="background-color: white;"| Raadplegen afspraak bij zorgaanbieder
|-
| style="background-color: white;"| AfspraakTypenRaadplegend
| style="background-color: white;"| EA-1.0.0-ATR-FHIR
| style="background-color: white;"| Raadplegen afspraak typen bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakSlotsRaadplegend
| style="background-color: white;"| EA-1.0.0-ASR-FHIR
| style="background-color: white;"| Raadplegen afspraak slots bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakWijzigingsverzoekSturend
| style="background-color: white;"| EA-1.0.0-AWS-FHIR
| style="background-color: white;"| Sturen afspraak wijzigingsverzoek
|-
| style="background-color: white;" rowspan="4"| XIS
| style="background-color: white;"| AfspraakBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak aan de patiënt
|-
| style="background-color: white;"| AfspraakTypenBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ATB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak typen
|-
| style="background-color: white;"| AfspraakSlotsBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ASB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak slots
|-
| style="background-color: white;"| AfspraakWijzigingsverzoekOntvangend
| style="background-color: white;"| EA-1.0.0-AWO-FHIR
| style="background-color: white;"| Ontvangen afspraak wijzigingsverzoek van de patiënt.
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak wijzigen (Totaal).png|Componenten diagram afspraak wijzigen]]

'''Componenten diagram afspraak wijzigen'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="8"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakSlots (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakTypen (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak typen
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ATR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak typen
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ATB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakWijziging (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraak wijzigingsverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AWS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraak wijzigingsverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AWO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak wijzigen.png|Use case diagram afspraak wijzigen]]

'''Use case diagram afspraak wijzigen

=Functionaliteit=
-

=Verantwoordelijkheid voor informatie=
Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

=Infrastructuur=
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| AUTEUR(S)
| style="background-color: white;"| TITEL
| style="background-color: white;"| VERSIE
| style="background-color: white;"| DATUM
| style="background-color: white;"| BRON
| style="background-color: white;"| ORGANISATIE
|}
'''Referenties

MedMij:V2018.04 OntwerpeAfspraak

2018-08-30T13:05:01Z

Marten Smits:

{{#customtitle:Use Cases eAfspraak, draft version}}
{{IssueBox|Dit is een werkpagina.

De gepubliceerde versie kan hier gevonden worden: https://informatiestandaarden.nictiz.nl/wiki/MedMij:Vcurrent_Ontwerpen}}
[[Bestand:EAfspraak_icoon_zonder_tekst.png |link=|links |87px|eAfspraak]]
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.04_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.04_FHIR_eAfspraak|Tecnical]]
desc none
</imagemap>

<div class="toclimit-{{{2|{{{limit|3}}}}}}">__TOC__</div>

=Inleiding=
Deze pagina beschrijft use cases waarbij een patiënt afspraken kan raadplegen, maken, annuleren of wijzigen met behulp van een persoonlijke gezondheidsomgeving. Algemene informatie betreffende deze use cases kan gevonden worden op deze [https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.04_Ontwerpen wiki pagina].

=Use Cases=
Deze sectie vervolgt met de volgende use cases:
*[[#Use_case:_Afspraak_raadplegen_door_pati.C3.ABnt|Afspraak raadplegen]]
*[[#Use_case:_Afspraak_maken_door_pati.C3.ABnt|Afspraak maken]]
*[[#Use_case:_Afspraak_annuleren_door_pati.C3.ABnt|Afspraak annuleren]]
*[[#Use_case:_Afspraak_wijzigen_door_pati.C3.ABnt|Afspraak wijzigen]]
==Use case: Afspraak raadplegen door patiënt==
===Doel en relevantie===
Inzicht in afspraken biedt patiënten overzicht en gebruiksgemak. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van afspraken vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===

====Raadplegen afspraak ====
Het raadplegen van een afspraak gaat van een specifieke patiënt naar een specifieke organisatie in de zorg (bijvoorbeeld een zorgaanbieder).

Verdere informatie-elementen in de vraag om afspraken zijn:
*periode (startdatum - einddatum) waarin de afspraak plaats heeft gehad / heeft / zal hebben
Dit betreft dus de filtermogelijkheden (query parameters) in de vraag om afspraken.

====Beschikbaarstellen afspraak ====
De informatie-elementen voor beschikbaarstellen afspraak staan in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak]

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil afspraken raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt afspraken beschikbaar
|}
'''Bedrijfsrollen afspraak inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak raadplegen.png|Activiteitendiagram afspraak raadplegen]]

'''Activiteitendiagram afspraak raadplegen'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een aantal voor Thomas relevante situaties waarbij het raadplegen van afspraken een rol speelt.

<blockquote>Thomas heeft iedere drie maanden een controle in het ziekenhuis in verband met zijn Diabetes aandoening. De eerstkomende afspraak is op vrijdag 6 oktober 2017 om 10:30u met internist Janssen bij het Antonius Ziekenhuis in Rotterdam en duurt een uur. Het ziekenhuisinformatiesysteem heeft deze afspraak beschikbaar gemaakt voor de persoonlijke gezondheidsomgeving van Thomas. Thomas kan deze afspraak dan ook inzien via zijn persoonlijke gezondheidsomgeving.
----
Op 6 september belt de afdelingssecretaresse van het ziekenhuis. Zij heeft het verzoek aan Thomas of de afspraak verzet kan worden naar dinsdag 3 oktober om 16:00 uur. Dat komt hem prima uit, dus hij gaat akkoord. Het ziekenhuisinformatiesysteem maakt deze nieuwe afspraakinformatie beschikbaar voor de persoonlijke gezondheidsomgeving. Wanneer Thomas later die dag kijkt, ziet hij ook de bijgewerkte afspraakinformatie in zijn persoonlijke gezondheidsomgeving. Wel zo makkelijk, want hij was het eerder die dag vergeten op te schrijven.
</blockquote>

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het systeem van een zorgaanbieder (XIS) stelt de afspraak beschikbaar aan het systeem van een patiënt (PGO).
Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.
=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

De patiënt wil afspraken inzien en de zorgaanbieder stelt dit ook beschikbaar.
Een patiënt neemt steeds zelf het initiatief om zijn afspraken te raadplegen.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om afspraken in te zien.

=====Post conditie=====
De patiënt heeft afspraken geraadpleegd via de persoonlijke gezondheidsomgeving.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om afspraken van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| AfspraakRaadplegend
| style="background-color: white;"| EA-1.0.0-AFR-FHIR
| style="background-color: white;"| Raadplegen afspraak bij zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| AfspraakBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak aan de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak raadplegen (Totaal).png |Componenten diagram afspraak raadplegen]]

'''Componenten diagram afspraak raadplegen'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak raadplegen.png|Use case diagram afspraak raadplegen]]

'''Use case diagram afspraak raadplegen

==Use case: Afspraak maken door patiënt==
===Doel en relevantie===
Het maken van afspraken via een persoonlijke gezondheidsomgeving biedt patiënten gebruiksgemak. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het elektronisch en gestructureerd afspraken kunnen maken vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn vastgelegd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots

Sturen afspraakverzoek
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots

Ontvangen afspraak verzoek
|}
'''Bedrijfsrollen Afspraak inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak maken.png|Activiteitendiagram afspraak maken]]

'''Activiteitendiagram maken afspraak'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het maken van afspraken een rol speelt.

<blockquote>De persoonlijke gezondheidsomgeving van Thomas en het ziekenhuisinformatiesysteem (ZIS) van het Noorderziekenhuis in Groningen zijn verbonden vanwege een eerder bezoek van Thomas in het ziekenhuis.

Thomas wil een afspraak maken voor de driemaandelijkse controle met een diabetesverpleegkundige. Hij wil dit ergens in de tweede week van januari. Zijn persoonlijke gezondheidsomgeving haalt de beschikbare tijden voor deze afspraak op uit het Groningse ziekenhuisinformatiesysteem. Thomas kiest voor woensdag 10 januari van 14:00 – 15:00 uur. Dit verzoek gaat via zijn persoonlijke gezondheidsomgeving naar het ziekenhuisinformatiesysteem, dat de ontvangst van dit verzoek bevestigt. De afspraak is door Thomas te raadplegen via zijn persoonlijke gezondheidsomgeving.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Een persoonlijke gezondheidsomgeving kan voor een bepaalde periode én een bepaald type afspraak de beschikbare tijden ophalen uit het XIS. Dit betreft het raadplegen van beschikbare afspraak slots. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan - op basis van beschikbare slots - een verzoek tot het maken van een concrete afspraak doen aan het XIS. Een XIS kan een dergelijk afspraakverzoek wel/niet in behandeling nemen en stuurt daarvan een bevestiging.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch maken van afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil bepaalde typen afspraken maken en de zorgaanbieder ondersteunt het maken van deze afspraken.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare slots voor een bepaald type afspraak in een bepaalde tijdsperiode bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de beschikbare afspraak slots op basis van de filter criteria uit de persoonlijke gezondheidsomgeving.
*Het systeem van de patiënt (PGO) stuurt een verzoek om een bepaald type afspraak te maken in een bepaalde slot.
*Het systeem van de zorgaanbieder (XIS) ontvangt het afspraakverzoek en geeft een technisch antwoord. Het antwoord geeft aan of het verzoek wel of niet in behandeling genomen kan worden.

Indien een verzoek in behandeling genomen kan worden door XIS, dan kan verwerking enige tijd vergen. Het verzoek wordt niet altijd direct afgehandeld.

Bij een eventueel negatief antwoord van het XIS kan een patiënt ervoor kiezen het opnieuw proberen, bijvoorbeeld met een ander (opnieuw opgevraagd) slot.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een afspraakverzoek.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| AfspraakSlotsRaadplegend
| style="background-color: white;"| EA-1.0.0-ASR-FHIR
| style="background-color: white;"| Raadplegen afspraak slots bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakverzoekSturend
| style="background-color: white;"| EA-1.0.0-AVS-FHIR
| style="background-color: white;"| Sturen afspraakverzoek naar zorgaanbieder
|-
| style="background-color: white;"| AfspraakSlotsBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ASB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak slots
|-
| style="background-color: white;"| AfspraakverzoekOntvangend
| style="background-color: white;"| EA-1.0.0-AVO-FHIR
| style="background-color: white;"| Ontvangen afspraakverzoek van de patient
|-
|}
Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak maken (Totaal).png|Componenten diagram afspraak maken]]

'''Componenten diagram afspraak maken'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakSlots (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="6"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakVerzoek (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraakverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AVS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraakverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AVO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak maken.png|Use case diagram afspraak maken]]

'''Use case diagram afspraak maken

==Use case: Afspraak annuleren door patiënt==
===Doel en relevantie===
Inzicht in afspraken biedt patiënten overzicht en gebruiksgemak. Dat is een functionaliteit die voorwaardelijk is voor deze use case: 'annuleren van afspraken'. Een patiënt is verder geholpen door ook afspraken te kunnen annuleren vanuit een persoonlijke gezondheidsomgeving. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het kunnen annuleren van een afspraak vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn gedefinieerd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
Sturen afspraak annulering
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
Ontvangen afspraak annulering
|}
'''Bedrijfsrollen afspraken inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak annuleren.png|Activiteitendiagram afspraak annuleren]]

'''Activiteitendiagram afspraak annuleren'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het annuleren van afspraken een rol speelt.

<blockquote>Thomas verhuist halverwege oktober 2017 voor zijn afstuderen naar Groningen. De afspraak voor de driemaandelijkse controle was al gemaakt in Rotterdam voor vrijdag 5 januari 2018. Thomas wil nu die afspraak afzeggen omdat hij die dag bezet is vanwege zijn afstudeerstage. Een nieuwe afspraak maakt hij liever in Groningen, dat is voor hem nu veel handiger.
Hij gebruikt zijn PGO om een verzoek te doen de afspraak in Rotterdam te annuleren. Een aantal uren later bevestigt de medisch secretaresse deze annulering. Thomas kan de afspraken weer raadplegen via zijn PGO.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Een persoonlijke gezondheidsomgeving kan achterhalen welk afspraken het verbonden XIS heeft voor de patiënt. Dit betreft het raadplegen van afspraken. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan voor een bestaande afspraak een verzoek doen tot annulering. Een XIS ontvangt, behandelt en beantwoordt een dergelijk verzoek.

Een PGO heeft afspraken geraadpleegd en opvolging verzoek beoordeeld. Mocht het verzoek niet verwerkt zijn, kan een patiënt ervoor kiezen het opnieuw te proberen, of op een andere manier de zorgaanbieder te benaderen. Indien het verzoek verwerkt is, stelt XIS bij raadpleging door PGO de afspraak met status ‘geannuleerd’ beschikbaar.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van informatie over afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil bepaalde afspraken kunnen annuleren en de zorgaanbieder ondersteunt dit.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) raadpleegt de beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Het systeem van de patiënt (PGO) stuurt een verzoek om de bestaande afspraak te annuleren.
*Het systeem van de zorgaanbieder (XIS) ontvangt de annulering en geeft een technisch antwoord. Het antwoord kan positief of negatief zijn voor het doorvoeren van de annulering.
*Het systeem van de patiënt (PGO) raadpleegt de beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken (waaronder de geannuleerde afspraak met status 'geannuleerd') op voor de patiënt.

Indien het verzoek verwerkt kan worden, stelt XIS de afspraak met status 'geannuleerd' beschikbaar, na raadpleging door patiënt vanuit zijn PGO.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een verzoek tot annulering van een afspraak.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="2"| PGO
| style="background-color: white;"| AfsprakenRaadplegend
| style="background-color: white;"| EA-1.0.0-AFR-FHIR
| style="background-color: white;"| Raadplegen afspraken bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakAnnuleringSturend
| style="background-color: white;"| EA-1.0.0-AAS-FHIR
| style="background-color: white;"| Sturen afspraak annulering naar de zorgaanbieder
|-
| style="background-color: white;" rowspan="2"| XIS
| style="background-color: white;"| AfsprakenBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraken aan de patiënt
|-
| style="background-color: white;"| AfspraakAnnuleringOntvangend
| style="background-color: white;"| EA-1.0.0-AAO-FHIR
| style="background-color: white;"| Ontvangen afspraak annulering van de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak annuleren (Totaal).png |Componenten diagram afspraak annuleren]]

'''Componenten diagram afspraak annuleren'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="4"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakAnnulering (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraak annulering
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AAS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraak annulering
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AAO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak annuleren.png |Use case diagram afspraak annuleren]]

'''Use case diagram afspraak annuleren

==Use case: Afspraak wijzigen door patiënt==
===Doel en relevantie===
Inzicht in en het maken van afspraken biedt patiënten overzicht en gebruiksgemak. Dat zijn functionaliteiten die voorwaardelijk zijn voor deze use case: 'wijzigen van afspraken'. Een patiënt is verder geholpen door ook afspraken te kunnen wijzigen vanuit een persoonlijke gezondheidsomgeving. Een wijziging kan ook een annulering betreffen. Dit draagt verder bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het kunnen wijzigen van een afspraak vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn gedefinieerd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak

Raadplegen afspraak slots

Sturen afspraak wijzigingsverzoek
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak

Beschikbaarstellen afspraak slots

Ontvangen afspraak wijzigingsverzoek
|}
'''Bedrijfsrollen afspraken inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak wijzigen.png|Activiteitendiagram afspraak wijzigen]]

'''Activiteitendiagram afspraak wijzigen'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het wijzigen van afspraken een rol speelt.

<blockquote>In de loop van december krijgt Thomas een buitenkansje. Een aantal van zijn vrienden gaan met skivakantie van zaterdag 5 t/m 12 januari en er is een plekje vrijgekomen. Voor een zacht prijsje kan hij mee. Daar heeft hij veel zin in!

Thomas zet de skivakantie ‘s avonds laat in zijn agenda en ziet dat dit conflicteert met zijn controle-afspraak in het Noorderziekenhuis op 10 januari. Hij moet die afspraak gaan verzetten. Het is 23:15 en dus te laat om het ziekenhuis hiervoor direct te bellen.

Via zijn PGO kijkt hij daarom naar beschikbare tijden in de derde week van januari. Er blijkt gelukkig nog een gaatje te zijn op vrijdag 19 januari om 11:30 – 12:30. Het verzoek om te wijzigen gaat via zijn PGO naar het ZIS, dat de ontvangst van het verzoek bevestigt. Bij raadpleging van de afspraken vanuit PGO, stelt XIS de nieuwe afspraak beschikbaar, alsmede de oorspronkelijke afspraak met status ‘ geannuleerd’.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Het systeem van een zorgaanbieder (XIS) stelt afspraken beschikbaar aan het systeem van een patiënt (PGO).
*Een persoonlijke gezondheidsomgeving kan achterhalen welk type afspraken het verbonden XIS ondersteunt: dit betreft het raadplegen van typen afspraken. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan voor een bepaalde periode én een bepaald type afspraak de beschikbare tijden ophalen uit het XIS. Dit betreft het raadplegen van beschikbare afspraak slots. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan - op basis van beschikbare slots - een verzoek tot het wijzigen van een concrete afspraak doen aan het XIS. Een XIS kan een dergelijk afspraak wijzigingsverzoek behandelen en ontvangst van het verzoek bevestigen.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van informatie over afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil een afspraak wijzigen en de zorgaanbieder ondersteunt het wijzigen van afspraken.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om afspraken in te zien en er één te selecteren die hij wil wijzigen.
*Het systeem van de patiënt (PGO) vraagt om beschikbare typen afspraken die gemaakt kunnen worden bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de typen afspraken.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om beschikbare typen afspraken in te zien en er één te selecteren.
*Het systeem van de patiënt (PGO) vraagt om beschikbare slots voor een bepaald type afspraak in een bepaalde tijdsperiode bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de beschikbare afspraak slots op basis van de filter criteria uit de persoonlijke gezondheidsomgeving.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om beschikbare slots in te zien en er één te selecteren.
*Het systeem van de patiënt (PGO) stuurt een verzoek om de bestaande afspraak te wijzigen.
*Het systeem van de zorgaanbieder (XIS) ontvangt het afspraak wijzigingsverzoek en geeft een technisch antwoord. Het antwoord kan positief of negatief zijn voor de wijziging.

Patiënt raadpleegt opnieuw de afspraken vanuit zijn PGO + XIS stelt de nieuwe afspraak beschikbaar, alsmede de oorspronkelijke afspraak met status ‘geannuleerd’.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een afspraak wijzigingsverzoek.

Bij een eventueel negatief antwoord van het XIS kan een patiënt ervoor kiezen het opnieuw proberen, bijvoorbeeld met een ander (opnieuw opgevraagd) slot.
Bij een positief antwoord is de afspraak gewijzigd en inzichtelijk in zowel XIS als PGO.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="4"| PGO
| style="background-color: white;"| AfspraakRaadplegend
| style="background-color: white;"| EA-1.0.0-AFO-FHIR
| style="background-color: white;"| Raadplegen afspraak bij zorgaanbieder
|-
| style="background-color: white;"| AfspraakTypenRaadplegend
| style="background-color: white;"| EA-1.0.0-ATR-FHIR
| style="background-color: white;"| Raadplegen afspraak typen bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakSlotsRaadplegend
| style="background-color: white;"| EA-1.0.0-ASR-FHIR
| style="background-color: white;"| Raadplegen afspraak slots bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakWijzigingsverzoekSturend
| style="background-color: white;"| EA-1.0.0-AWS-FHIR
| style="background-color: white;"| Sturen afspraak wijzigingsverzoek
|-
| style="background-color: white;" rowspan="4"| XIS
| style="background-color: white;"| AfspraakBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak aan de patiënt
|-
| style="background-color: white;"| AfspraakTypenBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ATB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak typen
|-
| style="background-color: white;"| AfspraakSlotsBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ASB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak slots
|-
| style="background-color: white;"| AfspraakWijzigingsverzoekOntvangend
| style="background-color: white;"| EA-1.0.0-AWO-FHIR
| style="background-color: white;"| Ontvangen afspraak wijzigingsverzoek van de patiënt.
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak wijzigen (Totaal).png|Componenten diagram afspraak wijzigen]]

'''Componenten diagram afspraak wijzigen'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="8"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakSlots (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakTypen (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak typen
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ATR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak typen
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ATB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakWijziging (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraak wijzigingsverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AWS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraak wijzigingsverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AWO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak wijzigen.png|Use case diagram afspraak wijzigen]]

'''Use case diagram afspraak wijzigen

=Functionaliteit=
-

=Verantwoordelijkheid voor informatie=
Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

=Infrastructuur=
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| AUTEUR(S)
| style="background-color: white;"| TITEL
| style="background-color: white;"| VERSIE
| style="background-color: white;"| DATUM
| style="background-color: white;"| BRON
| style="background-color: white;"| ORGANISATIE
|}
'''Referenties

MedMij:V2018.04 OntwerpeAfspraak

2018-08-30T13:03:50Z

Marten Smits: /* Systemen & Systeemrollen */

{{#customtitle:Use Cases eAfspraak, draft version}}
{{IssueBox|Dit is een werkpagina.

De gepubliceerde versie kan hier gevonden worden: https://informatiestandaarden.nictiz.nl/wiki/MedMij:Vcurrent_Ontwerpen}}
[[Bestand:EAfspraak_icoon_zonder_tekst.png |link=|links |87px|eAfspraak]]
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.04_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.04_FHIR_eAfspraak|Tecnical]]
desc none
</imagemap>

<div class="toclimit-{{{2|{{{limit|3}}}}}}">__TOC__</div>

=Inleiding=
Deze pagina beschrijft use cases waarbij een patiënt afspraken kan raadplegen, maken, annuleren of wijzigen met behulp van een persoonlijke gezondheidsomgeving. Algemene informatie betreffende deze use cases kan gevonden worden op deze [https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.04_Ontwerpen wiki pagina].

=Use Cases=
Deze sectie vervolgt met de volgende use cases:
*[[#Use_case:_Afspraak_raadplegen_door_pati.C3.ABnt|Afspraak raadplegen]]
*[[#Use_case:_Afspraak_maken_door_pati.C3.ABnt|Afspraak maken]]
*[[#Use_case:_Afspraak_annuleren_door_pati.C3.ABnt|Afspraak annuleren]]
*[[#Use_case:_Afspraak_wijzigen_door_pati.C3.ABnt|Afspraak wijzigen]]
==Use case: Afspraak raadplegen door patiënt==
===Doel en relevantie===
Inzicht in afspraken biedt patiënten overzicht en gebruiksgemak. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van afspraken vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===

====Raadplegen afspraak ====
Het raadplegen van een afspraak gaat van een specifieke patiënt naar een specifieke organisatie in de zorg (bijvoorbeeld een zorgaanbieder).

Verdere informatie-elementen in de vraag om afspraken zijn:
*periode (startdatum - einddatum) waarin de afspraak plaats heeft gehad / heeft / zal hebben
Dit betreft dus de filtermogelijkheden (query parameters) in de vraag om afspraken.

====Beschikbaarstellen afspraak ====
De informatie-elementen voor beschikbaarstellen afspraak staan in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak]

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil afspraken raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt afspraken beschikbaar
|}
'''Bedrijfsrollen afspraak inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak raadplegen.png|Activiteitendiagram afspraak raadplegen]]

'''Activiteitendiagram afspraak raadplegen'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een aantal voor Thomas relevante situaties waarbij het raadplegen van afspraken een rol speelt.

<blockquote>Thomas heeft iedere drie maanden een controle in het ziekenhuis in verband met zijn Diabetes aandoening. De eerstkomende afspraak is op vrijdag 6 oktober 2017 om 10:30u met internist Janssen bij het Antonius Ziekenhuis in Rotterdam en duurt een uur. Het ziekenhuisinformatiesysteem heeft deze afspraak beschikbaar gemaakt voor de persoonlijke gezondheidsomgeving van Thomas. Thomas kan deze afspraak dan ook inzien via zijn persoonlijke gezondheidsomgeving.
----
Op 6 september belt de afdelingssecretaresse van het ziekenhuis. Zij heeft het verzoek aan Thomas of de afspraak verzet kan worden naar dinsdag 3 oktober om 16:00 uur. Dat komt hem prima uit, dus hij gaat akkoord. Het ziekenhuisinformatiesysteem maakt deze nieuwe afspraakinformatie beschikbaar voor de persoonlijke gezondheidsomgeving. Wanneer Thomas later die dag kijkt, ziet hij ook de bijgewerkte afspraakinformatie in zijn persoonlijke gezondheidsomgeving. Wel zo makkelijk, want hij was het eerder die dag vergeten op te schrijven.
</blockquote>

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het systeem van een zorgaanbieder (XIS) stelt de afspraak beschikbaar aan het systeem van een patiënt (PGO).
Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.
=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

De patiënt wil afspraken inzien en de zorgaanbieder stelt dit ook beschikbaar.
Een patiënt neemt steeds zelf het initiatief om zijn afspraken te raadplegen.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om afspraken in te zien.

=====Post conditie=====
De patiënt heeft afspraken geraadpleegd via de persoonlijke gezondheidsomgeving.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om afspraken van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| AfspraakRaadplegend
| style="background-color: white;"| EA-1.0.0-AFR-FHIR
| style="background-color: white;"| Raadplegen afspraak bij zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| AfspraakBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak aan de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak raadplegen (Totaal).png |Componenten diagram afspraak raadplegen]]

'''Componenten diagram afspraak raadplegen'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak raadplegen.png|Use case diagram afspraak raadplegen]]

'''Use case diagram afspraak raadplegen

==Use case: Afspraak maken door patiënt==
===Doel en relevantie===
Het maken van afspraken via een persoonlijke gezondheidsomgeving biedt patiënten gebruiksgemak. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het elektronisch en gestructureerd afspraken kunnen maken vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn vastgelegd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots

Sturen afspraakverzoek
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots

Ontvangen afspraak verzoek
|}
'''Bedrijfsrollen Afspraak inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak maken.png|Activiteitendiagram afspraak maken]]

'''Activiteitendiagram maken afspraak'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het maken van afspraken een rol speelt.

<blockquote>De persoonlijke gezondheidsomgeving van Thomas en het ziekenhuisinformatiesysteem (ZIS) van het Noorderziekenhuis in Groningen zijn verbonden vanwege een eerder bezoek van Thomas in het ziekenhuis.

Thomas wil een afspraak maken voor de driemaandelijkse controle met een diabetesverpleegkundige. Hij wil dit ergens in de tweede week van januari. Zijn persoonlijke gezondheidsomgeving haalt de beschikbare tijden voor deze afspraak op uit het Groningse ziekenhuisinformatiesysteem. Thomas kiest voor woensdag 10 januari van 14:00 – 15:00 uur. Dit verzoek gaat via zijn persoonlijke gezondheidsomgeving naar het ziekenhuisinformatiesysteem, dat de ontvangst van dit verzoek bevestigt. De afspraak is door Thomas te raadplegen via zijn persoonlijke gezondheidsomgeving.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Een persoonlijke gezondheidsomgeving kan voor een bepaalde periode én een bepaald type afspraak de beschikbare tijden ophalen uit het XIS. Dit betreft het raadplegen van beschikbare afspraak slots. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan - op basis van beschikbare slots - een verzoek tot het maken van een concrete afspraak doen aan het XIS. Een XIS kan een dergelijk afspraakverzoek wel/niet in behandeling nemen en stuurt daarvan een bevestiging.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch maken van afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil bepaalde typen afspraken maken en de zorgaanbieder ondersteunt het maken van deze afspraken.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare slots voor een bepaald type afspraak in een bepaalde tijdsperiode bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de beschikbare afspraak slots op basis van de filter criteria uit de persoonlijke gezondheidsomgeving.
*Het systeem van de patiënt (PGO) stuurt een verzoek om een bepaald type afspraak te maken in een bepaalde slot.
*Het systeem van de zorgaanbieder (XIS) ontvangt het afspraakverzoek en geeft een technisch antwoord. Het antwoord geeft aan of het verzoek wel of niet in behandeling genomen kan worden.

Indien een verzoek in behandeling genomen kan worden door XIS, dan kan verwerking enige tijd vergen. Het verzoek wordt niet altijd direct afgehandeld.

Bij een eventueel negatief antwoord van het XIS kan een patiënt ervoor kiezen het opnieuw proberen, bijvoorbeeld met een ander (opnieuw opgevraagd) slot.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een afspraakverzoek.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| AfspraakSlotsRaadplegend
| style="background-color: white;"| EA-1.0.0-ASR-FHIR
| style="background-color: white;"| Raadplegen afspraak slots bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakverzoekSturend
| style="background-color: white;"| EA-1.0.0-AVS-FHIR
| style="background-color: white;"| Sturen afspraakverzoek naar zorgaanbieder
|-
| style="background-color: white;"| AfspraakSlotsBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ASB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak slots
|-
| style="background-color: white;"| AfspraakverzoekOntvangend
| style="background-color: white;"| EA-1.0.0-AVO-FHIR
| style="background-color: white;"| Ontvangen afspraakverzoek van de patient
|-
|}
Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak maken (Totaal).png|Componenten diagram afspraak maken]]

'''Componenten diagram afspraak maken'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakSlots (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="6"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakVerzoek (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraakverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AVS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraakverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AVO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak maken.png|Use case diagram afspraak maken]]

'''Use case diagram afspraak maken

==Use case: Afspraak annuleren door patiënt==
===Doel en relevantie===
Inzicht in afspraken biedt patiënten overzicht en gebruiksgemak. Dat is een functionaliteit die voorwaardelijk is voor deze use case: 'annuleren van afspraken'. Een patiënt is verder geholpen door ook afspraken te kunnen annuleren vanuit een persoonlijke gezondheidsomgeving. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het kunnen annuleren van een afspraak vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn gedefinieerd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
Sturen afspraak annulering
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
Ontvangen afspraak annulering
|}
'''Bedrijfsrollen afspraken inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak annuleren.png|Activiteitendiagram afspraak annuleren]]

'''Activiteitendiagram afspraak annuleren'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het annuleren van afspraken een rol speelt.

<blockquote>Thomas verhuist halverwege oktober 2017 voor zijn afstuderen naar Groningen. De afspraak voor de driemaandelijkse controle was al gemaakt in Rotterdam voor vrijdag 5 januari 2018. Thomas wil nu die afspraak afzeggen omdat hij die dag bezet is vanwege zijn afstudeerstage. Een nieuwe afspraak maakt hij liever in Groningen, dat is voor hem nu veel handiger.
Hij gebruikt zijn PGO om een verzoek te doen de afspraak in Rotterdam te annuleren. Een aantal uren later bevestigt de medisch secretaresse deze annulering. Thomas kan de afspraken weer raadplegen via zijn PGO.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Een persoonlijke gezondheidsomgeving kan achterhalen welk afspraken het verbonden XIS heeft voor de patiënt. Dit betreft het raadplegen van afspraken. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan voor een bestaande afspraak een verzoek doen tot annulering. Een XIS ontvangt, behandelt en beantwoordt een dergelijk verzoek.

Een PGO heeft afspraken geraadpleegd en opvolging verzoek beoordeeld. Mocht het verzoek niet verwerkt zijn, kan een patiënt ervoor kiezen het opnieuw te proberen, of op een andere manier de zorgaanbieder te benaderen. Indien het verzoek verwerkt is, stelt XIS bij raadpleging door PGO de afspraak met status ‘geannuleerd’ beschikbaar.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van informatie over afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil bepaalde afspraken kunnen annuleren en de zorgaanbieder ondersteunt dit.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) raadpleegt de beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Het systeem van de patiënt (PGO) stuurt een verzoek om de bestaande afspraak te annuleren.
*Het systeem van de zorgaanbieder (XIS) ontvangt de annulering en geeft een technisch antwoord. Het antwoord kan positief of negatief zijn voor het doorvoeren van de annulering.
*Het systeem van de patiënt (PGO) raadpleegt de beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken (waaronder de geannuleerde afspraak met status 'geannuleerd') op voor de patiënt.

Indien het verzoek verwerkt kan worden, stelt XIS de afspraak met status 'geannuleerd' beschikbaar, na raadpleging door patiënt vanuit zijn PGO.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een verzoek tot annulering van een afspraak.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="2"| PGO
| style="background-color: white;"| AfsprakenRaadplegend
| style="background-color: white;"| EA-1.0.0-AFR-FHIR
| style="background-color: white;"| Raadplegen afspraken bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakAnnuleringSturend
| style="background-color: white;"| EA-1.0.0-AAS-FHIR
| style="background-color: white;"| Sturen afspraak annulering naar de zorgaanbieder
|-
| style="background-color: white;" rowspan="2"| XIS
| style="background-color: white;"| AfsprakenBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraken aan de patiënt
|-
| style="background-color: white;"| AfspraakAnnuleringOntvangend
| style="background-color: white;"| EA-1.0.0-AAO-FHIR
| style="background-color: white;"| Ontvangen afspraak annulering van de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak annuleren (Totaal).png |Componenten diagram afspraak annuleren]]

'''Componenten diagram afspraak annuleren'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="4"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakAnnulering (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraak annulering
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AAS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraak annulering
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AAO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak annuleren.png |Use case diagram afspraak annuleren]]

'''Use case diagram afspraak annuleren

==Use case: Afspraak wijzigen door patiënt==
===Doel en relevantie===
Inzicht in en het maken van afspraken biedt patiënten overzicht en gebruiksgemak. Dat zijn functionaliteiten die voorwaardelijk zijn voor deze use case: 'wijzigen van afspraken'. Een patiënt is verder geholpen door ook afspraken te kunnen wijzigen vanuit een persoonlijke gezondheidsomgeving. Een wijziging kan ook een annulering betreffen. Dit draagt verder bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het kunnen wijzigen van een afspraak vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn gedefinieerd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
Raadplegen afspraak typen

Raadplegen afspraak slots

Sturen afspraak wijzigingsverzoek
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
Beschikbaarstellen afspraak typen

Beschikbaarstellen afspraak slots

Ontvangen afspraak wijzigingsverzoek
|}
'''Bedrijfsrollen afspraken inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak wijzigen.png|Activiteitendiagram afspraak wijzigen]]

'''Activiteitendiagram afspraak wijzigen'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het wijzigen van afspraken een rol speelt.

<blockquote>In de loop van december krijgt Thomas een buitenkansje. Een aantal van zijn vrienden gaan met skivakantie van zaterdag 5 t/m 12 januari en er is een plekje vrijgekomen. Voor een zacht prijsje kan hij mee. Daar heeft hij veel zin in!

Thomas zet de skivakantie ‘s avonds laat in zijn agenda en ziet dat dit conflicteert met zijn controle-afspraak in het Noorderziekenhuis op 10 januari. Hij moet die afspraak gaan verzetten. Het is 23:15 en dus te laat om het ziekenhuis hiervoor direct te bellen.

Via zijn PGO kijkt hij daarom naar beschikbare tijden in de derde week van januari. Er blijkt gelukkig nog een gaatje te zijn op vrijdag 19 januari om 11:30 – 12:30. Het verzoek om te wijzigen gaat via zijn PGO naar het ZIS, dat de ontvangst van het verzoek bevestigt. Bij raadpleging van de afspraken vanuit PGO, stelt XIS de nieuwe afspraak beschikbaar, alsmede de oorspronkelijke afspraak met status ‘ geannuleerd’.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Het systeem van een zorgaanbieder (XIS) stelt afspraken beschikbaar aan het systeem van een patiënt (PGO).
*Een persoonlijke gezondheidsomgeving kan achterhalen welk type afspraken het verbonden XIS ondersteunt: dit betreft het raadplegen van typen afspraken. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan voor een bepaalde periode én een bepaald type afspraak de beschikbare tijden ophalen uit het XIS. Dit betreft het raadplegen van beschikbare afspraak slots. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan - op basis van beschikbare slots - een verzoek tot het wijzigen van een concrete afspraak doen aan het XIS. Een XIS kan een dergelijk afspraak wijzigingsverzoek behandelen en ontvangst van het verzoek bevestigen.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van informatie over afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil een afspraak wijzigen en de zorgaanbieder ondersteunt het wijzigen van afspraken.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om afspraken in te zien en er één te selecteren die hij wil wijzigen.
*Het systeem van de patiënt (PGO) vraagt om beschikbare typen afspraken die gemaakt kunnen worden bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de typen afspraken.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om beschikbare typen afspraken in te zien en er één te selecteren.
*Het systeem van de patiënt (PGO) vraagt om beschikbare slots voor een bepaald type afspraak in een bepaalde tijdsperiode bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de beschikbare afspraak slots op basis van de filter criteria uit de persoonlijke gezondheidsomgeving.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om beschikbare slots in te zien en er één te selecteren.
*Het systeem van de patiënt (PGO) stuurt een verzoek om de bestaande afspraak te wijzigen.
*Het systeem van de zorgaanbieder (XIS) ontvangt het afspraak wijzigingsverzoek en geeft een technisch antwoord. Het antwoord kan positief of negatief zijn voor de wijziging.

Patiënt raadpleegt opnieuw de afspraken vanuit zijn PGO + XIS stelt de nieuwe afspraak beschikbaar, alsmede de oorspronkelijke afspraak met status ‘geannuleerd’.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een afspraak wijzigingsverzoek.

Bij een eventueel negatief antwoord van het XIS kan een patiënt ervoor kiezen het opnieuw proberen, bijvoorbeeld met een ander (opnieuw opgevraagd) slot.
Bij een positief antwoord is de afspraak gewijzigd en inzichtelijk in zowel XIS als PGO.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="4"| PGO
| style="background-color: white;"| AfspraakRaadplegend
| style="background-color: white;"| EA-1.0.0-AFO-FHIR
| style="background-color: white;"| Raadplegen afspraak bij zorgaanbieder
|-
| style="background-color: white;"| AfspraakTypenRaadplegend
| style="background-color: white;"| EA-1.0.0-ATR-FHIR
| style="background-color: white;"| Raadplegen afspraak typen bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakSlotsRaadplegend
| style="background-color: white;"| EA-1.0.0-ASR-FHIR
| style="background-color: white;"| Raadplegen afspraak slots bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakWijzigingsverzoekSturend
| style="background-color: white;"| EA-1.0.0-AWS-FHIR
| style="background-color: white;"| Sturen afspraak wijzigingsverzoek
|-
| style="background-color: white;" rowspan="4"| XIS
| style="background-color: white;"| AfspraakBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak aan de patiënt
|-
| style="background-color: white;"| AfspraakTypenBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ATB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak typen
|-
| style="background-color: white;"| AfspraakSlotsBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ASB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak slots
|-
| style="background-color: white;"| AfspraakWijzigingsverzoekOntvangend
| style="background-color: white;"| EA-1.0.0-AWO-FHIR
| style="background-color: white;"| Ontvangen afspraak wijzigingsverzoek van de patiënt.
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak wijzigen (Totaal).png|Componenten diagram afspraak wijzigen]]

'''Componenten diagram afspraak wijzigen'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="8"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakSlots (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakTypen (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak typen
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ATR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak typen
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ATB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakWijziging (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraak wijzigingsverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AWS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraak wijzigingsverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AWO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak wijzigen.png|Use case diagram afspraak wijzigen]]

'''Use case diagram afspraak wijzigen

=Functionaliteit=
-

=Verantwoordelijkheid voor informatie=
Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

=Infrastructuur=
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| AUTEUR(S)
| style="background-color: white;"| TITEL
| style="background-color: white;"| VERSIE
| style="background-color: white;"| DATUM
| style="background-color: white;"| BRON
| style="background-color: white;"| ORGANISATIE
|}
'''Referenties

MedMij:V2018.04 OntwerpeAfspraak

2018-08-30T13:02:47Z

Marten Smits:

{{#customtitle:Use Cases eAfspraak, draft version}}
{{IssueBox|Dit is een werkpagina.

De gepubliceerde versie kan hier gevonden worden: https://informatiestandaarden.nictiz.nl/wiki/MedMij:Vcurrent_Ontwerpen}}
[[Bestand:EAfspraak_icoon_zonder_tekst.png |link=|links |87px|eAfspraak]]
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.04_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.04_FHIR_eAfspraak|Tecnical]]
desc none
</imagemap>

<div class="toclimit-{{{2|{{{limit|3}}}}}}">__TOC__</div>

=Inleiding=
Deze pagina beschrijft use cases waarbij een patiënt afspraken kan raadplegen, maken, annuleren of wijzigen met behulp van een persoonlijke gezondheidsomgeving. Algemene informatie betreffende deze use cases kan gevonden worden op deze [https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.04_Ontwerpen wiki pagina].

=Use Cases=
Deze sectie vervolgt met de volgende use cases:
*[[#Use_case:_Afspraak_raadplegen_door_pati.C3.ABnt|Afspraak raadplegen]]
*[[#Use_case:_Afspraak_maken_door_pati.C3.ABnt|Afspraak maken]]
*[[#Use_case:_Afspraak_annuleren_door_pati.C3.ABnt|Afspraak annuleren]]
*[[#Use_case:_Afspraak_wijzigen_door_pati.C3.ABnt|Afspraak wijzigen]]
==Use case: Afspraak raadplegen door patiënt==
===Doel en relevantie===
Inzicht in afspraken biedt patiënten overzicht en gebruiksgemak. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van afspraken vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===

====Raadplegen afspraak ====
Het raadplegen van een afspraak gaat van een specifieke patiënt naar een specifieke organisatie in de zorg (bijvoorbeeld een zorgaanbieder).

Verdere informatie-elementen in de vraag om afspraken zijn:
*periode (startdatum - einddatum) waarin de afspraak plaats heeft gehad / heeft / zal hebben
Dit betreft dus de filtermogelijkheden (query parameters) in de vraag om afspraken.

====Beschikbaarstellen afspraak ====
De informatie-elementen voor beschikbaarstellen afspraak staan in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak]

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil afspraken raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt afspraken beschikbaar
|}
'''Bedrijfsrollen afspraak inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak raadplegen.png|Activiteitendiagram afspraak raadplegen]]

'''Activiteitendiagram afspraak raadplegen'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een aantal voor Thomas relevante situaties waarbij het raadplegen van afspraken een rol speelt.

<blockquote>Thomas heeft iedere drie maanden een controle in het ziekenhuis in verband met zijn Diabetes aandoening. De eerstkomende afspraak is op vrijdag 6 oktober 2017 om 10:30u met internist Janssen bij het Antonius Ziekenhuis in Rotterdam en duurt een uur. Het ziekenhuisinformatiesysteem heeft deze afspraak beschikbaar gemaakt voor de persoonlijke gezondheidsomgeving van Thomas. Thomas kan deze afspraak dan ook inzien via zijn persoonlijke gezondheidsomgeving.
----
Op 6 september belt de afdelingssecretaresse van het ziekenhuis. Zij heeft het verzoek aan Thomas of de afspraak verzet kan worden naar dinsdag 3 oktober om 16:00 uur. Dat komt hem prima uit, dus hij gaat akkoord. Het ziekenhuisinformatiesysteem maakt deze nieuwe afspraakinformatie beschikbaar voor de persoonlijke gezondheidsomgeving. Wanneer Thomas later die dag kijkt, ziet hij ook de bijgewerkte afspraakinformatie in zijn persoonlijke gezondheidsomgeving. Wel zo makkelijk, want hij was het eerder die dag vergeten op te schrijven.
</blockquote>

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het systeem van een zorgaanbieder (XIS) stelt de afspraak beschikbaar aan het systeem van een patiënt (PGO).
Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.
=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

De patiënt wil afspraken inzien en de zorgaanbieder stelt dit ook beschikbaar.
Een patiënt neemt steeds zelf het initiatief om zijn afspraken te raadplegen.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om afspraken in te zien.

=====Post conditie=====
De patiënt heeft afspraken geraadpleegd via de persoonlijke gezondheidsomgeving.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om afspraken van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| AfspraakRaadplegend
| style="background-color: white;"| EA-1.0.0-AFR-FHIR
| style="background-color: white;"| Raadplegen afspraak bij zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| AfspraakBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak aan de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak raadplegen (Totaal).png |Componenten diagram afspraak raadplegen]]

'''Componenten diagram afspraak raadplegen'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak raadplegen.png|Use case diagram afspraak raadplegen]]

'''Use case diagram afspraak raadplegen

==Use case: Afspraak maken door patiënt==
===Doel en relevantie===
Het maken van afspraken via een persoonlijke gezondheidsomgeving biedt patiënten gebruiksgemak. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het elektronisch en gestructureerd afspraken kunnen maken vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn vastgelegd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots

Sturen afspraakverzoek
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots

Ontvangen afspraak verzoek
|}
'''Bedrijfsrollen Afspraak inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak maken.png|Activiteitendiagram afspraak maken]]

'''Activiteitendiagram maken afspraak'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het maken van afspraken een rol speelt.

<blockquote>De persoonlijke gezondheidsomgeving van Thomas en het ziekenhuisinformatiesysteem (ZIS) van het Noorderziekenhuis in Groningen zijn verbonden vanwege een eerder bezoek van Thomas in het ziekenhuis.

Thomas wil een afspraak maken voor de driemaandelijkse controle met een diabetesverpleegkundige. Hij wil dit ergens in de tweede week van januari. Zijn persoonlijke gezondheidsomgeving haalt de beschikbare tijden voor deze afspraak op uit het Groningse ziekenhuisinformatiesysteem. Thomas kiest voor woensdag 10 januari van 14:00 – 15:00 uur. Dit verzoek gaat via zijn persoonlijke gezondheidsomgeving naar het ziekenhuisinformatiesysteem, dat de ontvangst van dit verzoek bevestigt. De afspraak is door Thomas te raadplegen via zijn persoonlijke gezondheidsomgeving.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Een persoonlijke gezondheidsomgeving kan voor een bepaalde periode én een bepaald type afspraak de beschikbare tijden ophalen uit het XIS. Dit betreft het raadplegen van beschikbare afspraak slots. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan - op basis van beschikbare slots - een verzoek tot het maken van een concrete afspraak doen aan het XIS. Een XIS kan een dergelijk afspraakverzoek wel/niet in behandeling nemen en stuurt daarvan een bevestiging.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch maken van afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil bepaalde typen afspraken maken en de zorgaanbieder ondersteunt het maken van deze afspraken.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare slots voor een bepaald type afspraak in een bepaalde tijdsperiode bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de beschikbare afspraak slots op basis van de filter criteria uit de persoonlijke gezondheidsomgeving.
*Het systeem van de patiënt (PGO) stuurt een verzoek om een bepaald type afspraak te maken in een bepaalde slot.
*Het systeem van de zorgaanbieder (XIS) ontvangt het afspraakverzoek en geeft een technisch antwoord. Het antwoord geeft aan of het verzoek wel of niet in behandeling genomen kan worden.

Indien een verzoek in behandeling genomen kan worden door XIS, dan kan verwerking enige tijd vergen. Het verzoek wordt niet altijd direct afgehandeld.

Bij een eventueel negatief antwoord van het XIS kan een patiënt ervoor kiezen het opnieuw proberen, bijvoorbeeld met een ander (opnieuw opgevraagd) slot.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een afspraakverzoek.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="3"| PGO
| style="background-color: white;"| AfspraakTypenRaadplegend
| style="background-color: white;"| EA-1.0.0-ATR-FHIR
| style="background-color: white;"| Raadplegen afspraak typen bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakSlotsRaadplegend
| style="background-color: white;"| EA-1.0.0-ASR-FHIR
| style="background-color: white;"| Raadplegen afspraak slots bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakverzoekSturend
| style="background-color: white;"| EA-1.0.0-AVS-FHIR
| style="background-color: white;"| Sturen afspraakverzoek naar zorgaanbieder
|-
| style="background-color: white;" rowspan="3"| XIS
| style="background-color: white;"| AfspraakTypenBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ATB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak typen
|-
| style="background-color: white;"| AfspraakSlotsBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ASB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak slots
|-
| style="background-color: white;"| AfspraakverzoekOntvangend
| style="background-color: white;"| EA-1.0.0-AVO-FHIR
| style="background-color: white;"| Ontvangen afspraakverzoek van de patient
|-
|}
Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak maken (Totaal).png|Componenten diagram afspraak maken]]

'''Componenten diagram afspraak maken'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakSlots (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="6"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakVerzoek (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraakverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AVS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraakverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AVO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak maken.png|Use case diagram afspraak maken]]

'''Use case diagram afspraak maken

==Use case: Afspraak annuleren door patiënt==
===Doel en relevantie===
Inzicht in afspraken biedt patiënten overzicht en gebruiksgemak. Dat is een functionaliteit die voorwaardelijk is voor deze use case: 'annuleren van afspraken'. Een patiënt is verder geholpen door ook afspraken te kunnen annuleren vanuit een persoonlijke gezondheidsomgeving. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het kunnen annuleren van een afspraak vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn gedefinieerd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
Sturen afspraak annulering
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
Ontvangen afspraak annulering
|}
'''Bedrijfsrollen afspraken inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak annuleren.png|Activiteitendiagram afspraak annuleren]]

'''Activiteitendiagram afspraak annuleren'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het annuleren van afspraken een rol speelt.

<blockquote>Thomas verhuist halverwege oktober 2017 voor zijn afstuderen naar Groningen. De afspraak voor de driemaandelijkse controle was al gemaakt in Rotterdam voor vrijdag 5 januari 2018. Thomas wil nu die afspraak afzeggen omdat hij die dag bezet is vanwege zijn afstudeerstage. Een nieuwe afspraak maakt hij liever in Groningen, dat is voor hem nu veel handiger.
Hij gebruikt zijn PGO om een verzoek te doen de afspraak in Rotterdam te annuleren. Een aantal uren later bevestigt de medisch secretaresse deze annulering. Thomas kan de afspraken weer raadplegen via zijn PGO.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Een persoonlijke gezondheidsomgeving kan achterhalen welk afspraken het verbonden XIS heeft voor de patiënt. Dit betreft het raadplegen van afspraken. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan voor een bestaande afspraak een verzoek doen tot annulering. Een XIS ontvangt, behandelt en beantwoordt een dergelijk verzoek.

Een PGO heeft afspraken geraadpleegd en opvolging verzoek beoordeeld. Mocht het verzoek niet verwerkt zijn, kan een patiënt ervoor kiezen het opnieuw te proberen, of op een andere manier de zorgaanbieder te benaderen. Indien het verzoek verwerkt is, stelt XIS bij raadpleging door PGO de afspraak met status ‘geannuleerd’ beschikbaar.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van informatie over afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil bepaalde afspraken kunnen annuleren en de zorgaanbieder ondersteunt dit.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) raadpleegt de beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Het systeem van de patiënt (PGO) stuurt een verzoek om de bestaande afspraak te annuleren.
*Het systeem van de zorgaanbieder (XIS) ontvangt de annulering en geeft een technisch antwoord. Het antwoord kan positief of negatief zijn voor het doorvoeren van de annulering.
*Het systeem van de patiënt (PGO) raadpleegt de beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken (waaronder de geannuleerde afspraak met status 'geannuleerd') op voor de patiënt.

Indien het verzoek verwerkt kan worden, stelt XIS de afspraak met status 'geannuleerd' beschikbaar, na raadpleging door patiënt vanuit zijn PGO.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een verzoek tot annulering van een afspraak.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="2"| PGO
| style="background-color: white;"| AfsprakenRaadplegend
| style="background-color: white;"| EA-1.0.0-AFR-FHIR
| style="background-color: white;"| Raadplegen afspraken bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakAnnuleringSturend
| style="background-color: white;"| EA-1.0.0-AAS-FHIR
| style="background-color: white;"| Sturen afspraak annulering naar de zorgaanbieder
|-
| style="background-color: white;" rowspan="2"| XIS
| style="background-color: white;"| AfsprakenBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraken aan de patiënt
|-
| style="background-color: white;"| AfspraakAnnuleringOntvangend
| style="background-color: white;"| EA-1.0.0-AAO-FHIR
| style="background-color: white;"| Ontvangen afspraak annulering van de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak annuleren (Totaal).png |Componenten diagram afspraak annuleren]]

'''Componenten diagram afspraak annuleren'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="4"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakAnnulering (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraak annulering
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AAS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraak annulering
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AAO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak annuleren.png |Use case diagram afspraak annuleren]]

'''Use case diagram afspraak annuleren

==Use case: Afspraak wijzigen door patiënt==
===Doel en relevantie===
Inzicht in en het maken van afspraken biedt patiënten overzicht en gebruiksgemak. Dat zijn functionaliteiten die voorwaardelijk zijn voor deze use case: 'wijzigen van afspraken'. Een patiënt is verder geholpen door ook afspraken te kunnen wijzigen vanuit een persoonlijke gezondheidsomgeving. Een wijziging kan ook een annulering betreffen. Dit draagt verder bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het kunnen wijzigen van een afspraak vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn gedefinieerd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
Raadplegen afspraak typen

Raadplegen afspraak slots

Sturen afspraak wijzigingsverzoek
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
Beschikbaarstellen afspraak typen

Beschikbaarstellen afspraak slots

Ontvangen afspraak wijzigingsverzoek
|}
'''Bedrijfsrollen afspraken inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak wijzigen.png|Activiteitendiagram afspraak wijzigen]]

'''Activiteitendiagram afspraak wijzigen'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het wijzigen van afspraken een rol speelt.

<blockquote>In de loop van december krijgt Thomas een buitenkansje. Een aantal van zijn vrienden gaan met skivakantie van zaterdag 5 t/m 12 januari en er is een plekje vrijgekomen. Voor een zacht prijsje kan hij mee. Daar heeft hij veel zin in!

Thomas zet de skivakantie ‘s avonds laat in zijn agenda en ziet dat dit conflicteert met zijn controle-afspraak in het Noorderziekenhuis op 10 januari. Hij moet die afspraak gaan verzetten. Het is 23:15 en dus te laat om het ziekenhuis hiervoor direct te bellen.

Via zijn PGO kijkt hij daarom naar beschikbare tijden in de derde week van januari. Er blijkt gelukkig nog een gaatje te zijn op vrijdag 19 januari om 11:30 – 12:30. Het verzoek om te wijzigen gaat via zijn PGO naar het ZIS, dat de ontvangst van het verzoek bevestigt. Bij raadpleging van de afspraken vanuit PGO, stelt XIS de nieuwe afspraak beschikbaar, alsmede de oorspronkelijke afspraak met status ‘ geannuleerd’.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Het systeem van een zorgaanbieder (XIS) stelt afspraken beschikbaar aan het systeem van een patiënt (PGO).
*Een persoonlijke gezondheidsomgeving kan achterhalen welk type afspraken het verbonden XIS ondersteunt: dit betreft het raadplegen van typen afspraken. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan voor een bepaalde periode én een bepaald type afspraak de beschikbare tijden ophalen uit het XIS. Dit betreft het raadplegen van beschikbare afspraak slots. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan - op basis van beschikbare slots - een verzoek tot het wijzigen van een concrete afspraak doen aan het XIS. Een XIS kan een dergelijk afspraak wijzigingsverzoek behandelen en ontvangst van het verzoek bevestigen.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van informatie over afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil een afspraak wijzigen en de zorgaanbieder ondersteunt het wijzigen van afspraken.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om afspraken in te zien en er één te selecteren die hij wil wijzigen.
*Het systeem van de patiënt (PGO) vraagt om beschikbare typen afspraken die gemaakt kunnen worden bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de typen afspraken.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om beschikbare typen afspraken in te zien en er één te selecteren.
*Het systeem van de patiënt (PGO) vraagt om beschikbare slots voor een bepaald type afspraak in een bepaalde tijdsperiode bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de beschikbare afspraak slots op basis van de filter criteria uit de persoonlijke gezondheidsomgeving.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om beschikbare slots in te zien en er één te selecteren.
*Het systeem van de patiënt (PGO) stuurt een verzoek om de bestaande afspraak te wijzigen.
*Het systeem van de zorgaanbieder (XIS) ontvangt het afspraak wijzigingsverzoek en geeft een technisch antwoord. Het antwoord kan positief of negatief zijn voor de wijziging.

Patiënt raadpleegt opnieuw de afspraken vanuit zijn PGO + XIS stelt de nieuwe afspraak beschikbaar, alsmede de oorspronkelijke afspraak met status ‘geannuleerd’.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een afspraak wijzigingsverzoek.

Bij een eventueel negatief antwoord van het XIS kan een patiënt ervoor kiezen het opnieuw proberen, bijvoorbeeld met een ander (opnieuw opgevraagd) slot.
Bij een positief antwoord is de afspraak gewijzigd en inzichtelijk in zowel XIS als PGO.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="4"| PGO
| style="background-color: white;"| AfspraakRaadplegend
| style="background-color: white;"| EA-1.0.0-AFO-FHIR
| style="background-color: white;"| Raadplegen afspraak bij zorgaanbieder
|-
| style="background-color: white;"| AfspraakTypenRaadplegend
| style="background-color: white;"| EA-1.0.0-ATR-FHIR
| style="background-color: white;"| Raadplegen afspraak typen bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakSlotsRaadplegend
| style="background-color: white;"| EA-1.0.0-ASR-FHIR
| style="background-color: white;"| Raadplegen afspraak slots bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakWijzigingsverzoekSturend
| style="background-color: white;"| EA-1.0.0-AWS-FHIR
| style="background-color: white;"| Sturen afspraak wijzigingsverzoek
|-
| style="background-color: white;" rowspan="4"| XIS
| style="background-color: white;"| AfspraakBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak aan de patiënt
|-
| style="background-color: white;"| AfspraakTypenBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ATB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak typen
|-
| style="background-color: white;"| AfspraakSlotsBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ASB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak slots
|-
| style="background-color: white;"| AfspraakWijzigingsverzoekOntvangend
| style="background-color: white;"| EA-1.0.0-AWO-FHIR
| style="background-color: white;"| Ontvangen afspraak wijzigingsverzoek van de patiënt.
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak wijzigen (Totaal).png|Componenten diagram afspraak wijzigen]]

'''Componenten diagram afspraak wijzigen'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="8"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakSlots (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakTypen (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak typen
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ATR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak typen
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ATB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakWijziging (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraak wijzigingsverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AWS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraak wijzigingsverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AWO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak wijzigen.png|Use case diagram afspraak wijzigen]]

'''Use case diagram afspraak wijzigen

=Functionaliteit=
-

=Verantwoordelijkheid voor informatie=
Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

=Infrastructuur=
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| AUTEUR(S)
| style="background-color: white;"| TITEL
| style="background-color: white;"| VERSIE
| style="background-color: white;"| DATUM
| style="background-color: white;"| BRON
| style="background-color: white;"| ORGANISATIE
|}
'''Referenties

MedMij:V2018.04 OntwerpeAfspraak

2018-08-30T13:01:34Z

Marten Smits:

{{#customtitle:Use Cases eAfspraak, draft version}}
{{IssueBox|Dit is een werkpagina.

De gepubliceerde versie kan hier gevonden worden: https://informatiestandaarden.nictiz.nl/wiki/MedMij:Vcurrent_Ontwerpen}}
[[Bestand:EAfspraak_icoon_zonder_tekst.png |link=|links |87px|eAfspraak]]
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.04_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.04_FHIR_eAfspraak|Tecnical]]
desc none
</imagemap>

<div class="toclimit-{{{2|{{{limit|3}}}}}}">__TOC__</div>

=Inleiding=
Deze pagina beschrijft use cases waarbij een patiënt afspraken kan raadplegen, maken, annuleren of wijzigen met behulp van een persoonlijke gezondheidsomgeving. Algemene informatie betreffende deze use cases kan gevonden worden op deze [https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.04_Ontwerpen wiki pagina].

=Use Cases=
Deze sectie vervolgt met de volgende use cases:
*[[#Use_case:_Afspraak_raadplegen_door_pati.C3.ABnt|Afspraak raadplegen]]
*[[#Use_case:_Afspraak_maken_door_pati.C3.ABnt|Afspraak maken]]
*[[#Use_case:_Afspraak_annuleren_door_pati.C3.ABnt|Afspraak annuleren]]
*[[#Use_case:_Afspraak_wijzigen_door_pati.C3.ABnt|Afspraak wijzigen]]
==Use case: Afspraak raadplegen door patiënt==
===Doel en relevantie===
Inzicht in afspraken biedt patiënten overzicht en gebruiksgemak. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van afspraken vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===

====Raadplegen afspraak ====
Het raadplegen van een afspraak gaat van een specifieke patiënt naar een specifieke organisatie in de zorg (bijvoorbeeld een zorgaanbieder).

Verdere informatie-elementen in de vraag om afspraken zijn:
*periode (startdatum - einddatum) waarin de afspraak plaats heeft gehad / heeft / zal hebben
Dit betreft dus de filtermogelijkheden (query parameters) in de vraag om afspraken.

====Beschikbaarstellen afspraak ====
De informatie-elementen voor beschikbaarstellen afspraak staan in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak]

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil afspraken raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt afspraken beschikbaar
|}
'''Bedrijfsrollen afspraak inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak raadplegen.png|Activiteitendiagram afspraak raadplegen]]

'''Activiteitendiagram afspraak raadplegen'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een aantal voor Thomas relevante situaties waarbij het raadplegen van afspraken een rol speelt.

<blockquote>Thomas heeft iedere drie maanden een controle in het ziekenhuis in verband met zijn Diabetes aandoening. De eerstkomende afspraak is op vrijdag 6 oktober 2017 om 10:30u met internist Janssen bij het Antonius Ziekenhuis in Rotterdam en duurt een uur. Het ziekenhuisinformatiesysteem heeft deze afspraak beschikbaar gemaakt voor de persoonlijke gezondheidsomgeving van Thomas. Thomas kan deze afspraak dan ook inzien via zijn persoonlijke gezondheidsomgeving.
----
Op 6 september belt de afdelingssecretaresse van het ziekenhuis. Zij heeft het verzoek aan Thomas of de afspraak verzet kan worden naar dinsdag 3 oktober om 16:00 uur. Dat komt hem prima uit, dus hij gaat akkoord. Het ziekenhuisinformatiesysteem maakt deze nieuwe afspraakinformatie beschikbaar voor de persoonlijke gezondheidsomgeving. Wanneer Thomas later die dag kijkt, ziet hij ook de bijgewerkte afspraakinformatie in zijn persoonlijke gezondheidsomgeving. Wel zo makkelijk, want hij was het eerder die dag vergeten op te schrijven.
</blockquote>

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het systeem van een zorgaanbieder (XIS) stelt de afspraak beschikbaar aan het systeem van een patiënt (PGO).
Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.
=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

De patiënt wil afspraken inzien en de zorgaanbieder stelt dit ook beschikbaar.
Een patiënt neemt steeds zelf het initiatief om zijn afspraken te raadplegen.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om afspraken in te zien.

=====Post conditie=====
De patiënt heeft afspraken geraadpleegd via de persoonlijke gezondheidsomgeving.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om afspraken van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| AfspraakRaadplegend
| style="background-color: white;"| EA-1.0.0-AFR-FHIR
| style="background-color: white;"| Raadplegen afspraak bij zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| AfspraakBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak aan de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak raadplegen (Totaal).png |Componenten diagram afspraak raadplegen]]

'''Componenten diagram afspraak raadplegen'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak raadplegen.png|Use case diagram afspraak raadplegen]]

'''Use case diagram afspraak raadplegen

==Use case: Afspraak maken door patiënt==
===Doel en relevantie===
Het maken van afspraken via een persoonlijke gezondheidsomgeving biedt patiënten gebruiksgemak. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het elektronisch en gestructureerd afspraken kunnen maken vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn vastgelegd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots

Sturen afspraakverzoek
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots

Ontvangen afspraak verzoek
|}
'''Bedrijfsrollen Afspraak inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak maken.png|Activiteitendiagram afspraak maken]]

'''Activiteitendiagram maken afspraak'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het maken van afspraken een rol speelt.

<blockquote>De persoonlijke gezondheidsomgeving van Thomas en het ziekenhuisinformatiesysteem (ZIS) van het Noorderziekenhuis in Groningen zijn verbonden vanwege een eerder bezoek van Thomas in het ziekenhuis.

Thomas wil een afspraak maken voor de driemaandelijkse controle met een diabetesverpleegkundige. Hij wil dit ergens in de tweede week van januari. Zijn persoonlijke gezondheidsomgeving haalt de beschikbare tijden voor deze afspraak op uit het Groningse ziekenhuisinformatiesysteem. Thomas kiest voor woensdag 10 januari van 14:00 – 15:00 uur. Dit verzoek gaat via zijn persoonlijke gezondheidsomgeving naar het ziekenhuisinformatiesysteem, dat de ontvangst van dit verzoek bevestigt. De afspraak is door Thomas te raadplegen via zijn persoonlijke gezondheidsomgeving.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Een persoonlijke gezondheidsomgeving kan achterhalen welk type afspraken het verbonden XIS ondersteunt: dit betreft het raadplegen van typen afspraken. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan voor een bepaalde periode én een bepaald type afspraak de beschikbare tijden ophalen uit het XIS. Dit betreft het raadplegen van beschikbare afspraak slots. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan - op basis van beschikbare slots - een verzoek tot het maken van een concrete afspraak doen aan het XIS. Een XIS kan een dergelijk afspraakverzoek wel/niet in behandeling nemen en stuurt daarvan een bevestiging.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch maken van afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil bepaalde typen afspraken maken en de zorgaanbieder ondersteunt het maken van deze afspraken.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare typen afspraken die gemaakt kunnen worden bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de typen afspraken.
*Het systeem van de patiënt (PGO) vraagt om beschikbare slots voor een bepaald type afspraak in een bepaalde tijdsperiode bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de beschikbare afspraak slots op basis van de filter criteria uit de persoonlijke gezondheidsomgeving.
*Het systeem van de patiënt (PGO) stuurt een verzoek om een bepaald type afspraak te maken in een bepaalde slot.
*Het systeem van de zorgaanbieder (XIS) ontvangt het afspraakverzoek en geeft een technisch antwoord. Het antwoord geeft aan of het verzoek wel of niet in behandeling genomen kan worden.

Indien een verzoek in behandeling genomen kan worden door XIS, dan kan verwerking enige tijd vergen. Het verzoek wordt niet altijd direct afgehandeld.

Bij een eventueel negatief antwoord van het XIS kan een patiënt ervoor kiezen het opnieuw proberen, bijvoorbeeld met een ander (opnieuw opgevraagd) slot.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een afspraakverzoek.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="3"| PGO
| style="background-color: white;"| AfspraakTypenRaadplegend
| style="background-color: white;"| EA-1.0.0-ATR-FHIR
| style="background-color: white;"| Raadplegen afspraak typen bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakSlotsRaadplegend
| style="background-color: white;"| EA-1.0.0-ASR-FHIR
| style="background-color: white;"| Raadplegen afspraak slots bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakverzoekSturend
| style="background-color: white;"| EA-1.0.0-AVS-FHIR
| style="background-color: white;"| Sturen afspraakverzoek naar zorgaanbieder
|-
| style="background-color: white;" rowspan="3"| XIS
| style="background-color: white;"| AfspraakTypenBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ATB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak typen
|-
| style="background-color: white;"| AfspraakSlotsBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ASB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak slots
|-
| style="background-color: white;"| AfspraakverzoekOntvangend
| style="background-color: white;"| EA-1.0.0-AVO-FHIR
| style="background-color: white;"| Ontvangen afspraakverzoek van de patient
|-
|}
Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak maken (Totaal).png|Componenten diagram afspraak maken]]

'''Componenten diagram afspraak maken'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakSlots (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="6"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakVerzoek (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraakverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AVS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraakverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AVO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak maken.png|Use case diagram afspraak maken]]

'''Use case diagram afspraak maken

==Use case: Afspraak annuleren door patiënt==
===Doel en relevantie===
Inzicht in afspraken biedt patiënten overzicht en gebruiksgemak. Dat is een functionaliteit die voorwaardelijk is voor deze use case: 'annuleren van afspraken'. Een patiënt is verder geholpen door ook afspraken te kunnen annuleren vanuit een persoonlijke gezondheidsomgeving. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het kunnen annuleren van een afspraak vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn gedefinieerd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
Sturen afspraak annulering
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
Ontvangen afspraak annulering
|}
'''Bedrijfsrollen afspraken inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak annuleren.png|Activiteitendiagram afspraak annuleren]]

'''Activiteitendiagram afspraak annuleren'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het annuleren van afspraken een rol speelt.

<blockquote>Thomas verhuist halverwege oktober 2017 voor zijn afstuderen naar Groningen. De afspraak voor de driemaandelijkse controle was al gemaakt in Rotterdam voor vrijdag 5 januari 2018. Thomas wil nu die afspraak afzeggen omdat hij die dag bezet is vanwege zijn afstudeerstage. Een nieuwe afspraak maakt hij liever in Groningen, dat is voor hem nu veel handiger.
Hij gebruikt zijn PGO om een verzoek te doen de afspraak in Rotterdam te annuleren. Een aantal uren later bevestigt de medisch secretaresse deze annulering. Thomas kan de afspraken weer raadplegen via zijn PGO.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Een persoonlijke gezondheidsomgeving kan achterhalen welk afspraken het verbonden XIS heeft voor de patiënt. Dit betreft het raadplegen van afspraken. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan voor een bestaande afspraak een verzoek doen tot annulering. Een XIS ontvangt, behandelt en beantwoordt een dergelijk verzoek.

Een PGO heeft afspraken geraadpleegd en opvolging verzoek beoordeeld. Mocht het verzoek niet verwerkt zijn, kan een patiënt ervoor kiezen het opnieuw te proberen, of op een andere manier de zorgaanbieder te benaderen. Indien het verzoek verwerkt is, stelt XIS bij raadpleging door PGO de afspraak met status ‘geannuleerd’ beschikbaar.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van informatie over afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil bepaalde afspraken kunnen annuleren en de zorgaanbieder ondersteunt dit.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) raadpleegt de beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Het systeem van de patiënt (PGO) stuurt een verzoek om de bestaande afspraak te annuleren.
*Het systeem van de zorgaanbieder (XIS) ontvangt de annulering en geeft een technisch antwoord. Het antwoord kan positief of negatief zijn voor het doorvoeren van de annulering.
*Het systeem van de patiënt (PGO) raadpleegt de beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken (waaronder de geannuleerde afspraak met status 'geannuleerd') op voor de patiënt.

Indien het verzoek verwerkt kan worden, stelt XIS de afspraak met status 'geannuleerd' beschikbaar, na raadpleging door patiënt vanuit zijn PGO.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een verzoek tot annulering van een afspraak.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="2"| PGO
| style="background-color: white;"| AfsprakenRaadplegend
| style="background-color: white;"| EA-1.0.0-AFR-FHIR
| style="background-color: white;"| Raadplegen afspraken bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakAnnuleringSturend
| style="background-color: white;"| EA-1.0.0-AAS-FHIR
| style="background-color: white;"| Sturen afspraak annulering naar de zorgaanbieder
|-
| style="background-color: white;" rowspan="2"| XIS
| style="background-color: white;"| AfsprakenBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraken aan de patiënt
|-
| style="background-color: white;"| AfspraakAnnuleringOntvangend
| style="background-color: white;"| EA-1.0.0-AAO-FHIR
| style="background-color: white;"| Ontvangen afspraak annulering van de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak annuleren (Totaal).png |Componenten diagram afspraak annuleren]]

'''Componenten diagram afspraak annuleren'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="4"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakAnnulering (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraak annulering
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AAS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraak annulering
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AAO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak annuleren.png |Use case diagram afspraak annuleren]]

'''Use case diagram afspraak annuleren

==Use case: Afspraak wijzigen door patiënt==
===Doel en relevantie===
Inzicht in en het maken van afspraken biedt patiënten overzicht en gebruiksgemak. Dat zijn functionaliteiten die voorwaardelijk zijn voor deze use case: 'wijzigen van afspraken'. Een patiënt is verder geholpen door ook afspraken te kunnen wijzigen vanuit een persoonlijke gezondheidsomgeving. Een wijziging kan ook een annulering betreffen. Dit draagt verder bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het kunnen wijzigen van een afspraak vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn gedefinieerd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
Raadplegen afspraak typen

Raadplegen afspraak slots

Sturen afspraak wijzigingsverzoek
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
Beschikbaarstellen afspraak typen

Beschikbaarstellen afspraak slots

Ontvangen afspraak wijzigingsverzoek
|}
'''Bedrijfsrollen afspraken inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak wijzigen.png|Activiteitendiagram afspraak wijzigen]]

'''Activiteitendiagram afspraak wijzigen'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het wijzigen van afspraken een rol speelt.

<blockquote>In de loop van december krijgt Thomas een buitenkansje. Een aantal van zijn vrienden gaan met skivakantie van zaterdag 5 t/m 12 januari en er is een plekje vrijgekomen. Voor een zacht prijsje kan hij mee. Daar heeft hij veel zin in!

Thomas zet de skivakantie ‘s avonds laat in zijn agenda en ziet dat dit conflicteert met zijn controle-afspraak in het Noorderziekenhuis op 10 januari. Hij moet die afspraak gaan verzetten. Het is 23:15 en dus te laat om het ziekenhuis hiervoor direct te bellen.

Via zijn PGO kijkt hij daarom naar beschikbare tijden in de derde week van januari. Er blijkt gelukkig nog een gaatje te zijn op vrijdag 19 januari om 11:30 – 12:30. Het verzoek om te wijzigen gaat via zijn PGO naar het ZIS, dat de ontvangst van het verzoek bevestigt. Bij raadpleging van de afspraken vanuit PGO, stelt XIS de nieuwe afspraak beschikbaar, alsmede de oorspronkelijke afspraak met status ‘ geannuleerd’.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Het systeem van een zorgaanbieder (XIS) stelt afspraken beschikbaar aan het systeem van een patiënt (PGO).
*Een persoonlijke gezondheidsomgeving kan achterhalen welk type afspraken het verbonden XIS ondersteunt: dit betreft het raadplegen van typen afspraken. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan voor een bepaalde periode én een bepaald type afspraak de beschikbare tijden ophalen uit het XIS. Dit betreft het raadplegen van beschikbare afspraak slots. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan - op basis van beschikbare slots - een verzoek tot het wijzigen van een concrete afspraak doen aan het XIS. Een XIS kan een dergelijk afspraak wijzigingsverzoek behandelen en ontvangst van het verzoek bevestigen.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van informatie over afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil een afspraak wijzigen en de zorgaanbieder ondersteunt het wijzigen van afspraken.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om afspraken in te zien en er één te selecteren die hij wil wijzigen.
*Het systeem van de patiënt (PGO) vraagt om beschikbare typen afspraken die gemaakt kunnen worden bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de typen afspraken.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om beschikbare typen afspraken in te zien en er één te selecteren.
*Het systeem van de patiënt (PGO) vraagt om beschikbare slots voor een bepaald type afspraak in een bepaalde tijdsperiode bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de beschikbare afspraak slots op basis van de filter criteria uit de persoonlijke gezondheidsomgeving.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om beschikbare slots in te zien en er één te selecteren.
*Het systeem van de patiënt (PGO) stuurt een verzoek om de bestaande afspraak te wijzigen.
*Het systeem van de zorgaanbieder (XIS) ontvangt het afspraak wijzigingsverzoek en geeft een technisch antwoord. Het antwoord kan positief of negatief zijn voor de wijziging.

Patiënt raadpleegt opnieuw de afspraken vanuit zijn PGO + XIS stelt de nieuwe afspraak beschikbaar, alsmede de oorspronkelijke afspraak met status ‘geannuleerd’.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een afspraak wijzigingsverzoek.

Bij een eventueel negatief antwoord van het XIS kan een patiënt ervoor kiezen het opnieuw proberen, bijvoorbeeld met een ander (opnieuw opgevraagd) slot.
Bij een positief antwoord is de afspraak gewijzigd en inzichtelijk in zowel XIS als PGO.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="4"| PGO
| style="background-color: white;"| AfspraakRaadplegend
| style="background-color: white;"| EA-1.0.0-AFO-FHIR
| style="background-color: white;"| Raadplegen afspraak bij zorgaanbieder
|-
| style="background-color: white;"| AfspraakTypenRaadplegend
| style="background-color: white;"| EA-1.0.0-ATR-FHIR
| style="background-color: white;"| Raadplegen afspraak typen bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakSlotsRaadplegend
| style="background-color: white;"| EA-1.0.0-ASR-FHIR
| style="background-color: white;"| Raadplegen afspraak slots bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakWijzigingsverzoekSturend
| style="background-color: white;"| EA-1.0.0-AWS-FHIR
| style="background-color: white;"| Sturen afspraak wijzigingsverzoek
|-
| style="background-color: white;" rowspan="4"| XIS
| style="background-color: white;"| AfspraakBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak aan de patiënt
|-
| style="background-color: white;"| AfspraakTypenBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ATB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak typen
|-
| style="background-color: white;"| AfspraakSlotsBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ASB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak slots
|-
| style="background-color: white;"| AfspraakWijzigingsverzoekOntvangend
| style="background-color: white;"| EA-1.0.0-AWO-FHIR
| style="background-color: white;"| Ontvangen afspraak wijzigingsverzoek van de patiënt.
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak wijzigen (Totaal).png|Componenten diagram afspraak wijzigen]]

'''Componenten diagram afspraak wijzigen'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="8"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakSlots (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakTypen (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak typen
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ATR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak typen
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ATB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakWijziging (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraak wijzigingsverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AWS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraak wijzigingsverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AWO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak wijzigen.png|Use case diagram afspraak wijzigen]]

'''Use case diagram afspraak wijzigen

=Functionaliteit=
-

=Verantwoordelijkheid voor informatie=
Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

=Infrastructuur=
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| AUTEUR(S)
| style="background-color: white;"| TITEL
| style="background-color: white;"| VERSIE
| style="background-color: white;"| DATUM
| style="background-color: white;"| BRON
| style="background-color: white;"| ORGANISATIE
|}
'''Referenties

MedMij:V2018.04 OntwerpeAfspraak

2018-08-30T13:00:57Z

Marten Smits:

{{#customtitle:Use Cases eAfspraak, draft version}}
{{IssueBox|Dit is een werkpagina.

De gepubliceerde versie kan hier gevonden worden: https://informatiestandaarden.nictiz.nl/wiki/MedMij:Vcurrent_Ontwerpen}}
[[Bestand:EAfspraak_icoon_zonder_tekst.png |link=|links |87px|eAfspraak]]
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.04_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.04_FHIR_eAfspraak|Tecnical]]
desc none
</imagemap>

<div class="toclimit-{{{2|{{{limit|3}}}}}}">__TOC__</div>

=Inleiding=
Deze pagina beschrijft use cases waarbij een patiënt afspraken kan raadplegen, maken, annuleren of wijzigen met behulp van een persoonlijke gezondheidsomgeving. Algemene informatie betreffende deze use cases kan gevonden worden op deze [https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.04_Ontwerpen wiki pagina].

=Use Cases=
Deze sectie vervolgt met de volgende use cases:
*[[#Use_case:_Afspraak_raadplegen_door_pati.C3.ABnt|Afspraak raadplegen]]
*[[#Use_case:_Afspraak_maken_door_pati.C3.ABnt|Afspraak maken]]
*[[#Use_case:_Afspraak_annuleren_door_pati.C3.ABnt|Afspraak annuleren]]
*[[#Use_case:_Afspraak_wijzigen_door_pati.C3.ABnt|Afspraak wijzigen]]
==Use case: Afspraak raadplegen door patiënt==
===Doel en relevantie===
Inzicht in afspraken biedt patiënten overzicht en gebruiksgemak. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van afspraken vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===

====Raadplegen afspraak ====
Het raadplegen van een afspraak gaat van een specifieke patiënt naar een specifieke organisatie in de zorg (bijvoorbeeld een zorgaanbieder).

Verdere informatie-elementen in de vraag om afspraken zijn:
*periode (startdatum - einddatum) waarin de afspraak plaats heeft gehad / heeft / zal hebben
Dit betreft dus de filtermogelijkheden (query parameters) in de vraag om afspraken.

====Beschikbaarstellen afspraak ====
De informatie-elementen voor beschikbaarstellen afspraak staan in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak]

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil afspraken raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt afspraken beschikbaar
|}
'''Bedrijfsrollen afspraak inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak raadplegen.png|Activiteitendiagram afspraak raadplegen]]

'''Activiteitendiagram afspraak raadplegen'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een aantal voor Thomas relevante situaties waarbij het raadplegen van afspraken een rol speelt.

<blockquote>Thomas heeft iedere drie maanden een controle in het ziekenhuis in verband met zijn Diabetes aandoening. De eerstkomende afspraak is op vrijdag 6 oktober 2017 om 10:30u met internist Janssen bij het Antonius Ziekenhuis in Rotterdam en duurt een uur. Het ziekenhuisinformatiesysteem heeft deze afspraak beschikbaar gemaakt voor de persoonlijke gezondheidsomgeving van Thomas. Thomas kan deze afspraak dan ook inzien via zijn persoonlijke gezondheidsomgeving.
----
Op 6 september belt de afdelingssecretaresse van het ziekenhuis. Zij heeft het verzoek aan Thomas of de afspraak verzet kan worden naar dinsdag 3 oktober om 16:00 uur. Dat komt hem prima uit, dus hij gaat akkoord. Het ziekenhuisinformatiesysteem maakt deze nieuwe afspraakinformatie beschikbaar voor de persoonlijke gezondheidsomgeving. Wanneer Thomas later die dag kijkt, ziet hij ook de bijgewerkte afspraakinformatie in zijn persoonlijke gezondheidsomgeving. Wel zo makkelijk, want hij was het eerder die dag vergeten op te schrijven.
</blockquote>

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het systeem van een zorgaanbieder (XIS) stelt de afspraak beschikbaar aan het systeem van een patiënt (PGO).
Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.
=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

De patiënt wil afspraken inzien en de zorgaanbieder stelt dit ook beschikbaar.
Een patiënt neemt steeds zelf het initiatief om zijn afspraken te raadplegen.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om afspraken in te zien.

=====Post conditie=====
De patiënt heeft afspraken geraadpleegd via de persoonlijke gezondheidsomgeving.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om afspraken van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| AfspraakRaadplegend
| style="background-color: white;"| EA-1.0.0-AFR-FHIR
| style="background-color: white;"| Raadplegen afspraak bij zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| AfspraakBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak aan de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak raadplegen (Totaal).png |Componenten diagram afspraak raadplegen]]

'''Componenten diagram afspraak raadplegen'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak raadplegen.png|Use case diagram afspraak raadplegen]]

'''Use case diagram afspraak raadplegen

==Use case: Afspraak maken door patiënt==
===Doel en relevantie===
Het maken van afspraken via een persoonlijke gezondheidsomgeving biedt patiënten gebruiksgemak. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het elektronisch en gestructureerd afspraken kunnen maken vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn vastgelegd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots
Raadplegen afspraak typen

Sturen afspraakverzoek
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots
Beschikbaarstellen afspraak typen

Ontvangen afspraak verzoek
|}
'''Bedrijfsrollen Afspraak inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak maken.png|Activiteitendiagram afspraak maken]]

'''Activiteitendiagram maken afspraak'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het maken van afspraken een rol speelt.

<blockquote>De persoonlijke gezondheidsomgeving van Thomas en het ziekenhuisinformatiesysteem (ZIS) van het Noorderziekenhuis in Groningen zijn verbonden vanwege een eerder bezoek van Thomas in het ziekenhuis.

Thomas wil een afspraak maken voor de driemaandelijkse controle met een diabetesverpleegkundige. Hij wil dit ergens in de tweede week van januari. Zijn persoonlijke gezondheidsomgeving haalt de beschikbare tijden voor deze afspraak op uit het Groningse ziekenhuisinformatiesysteem. Thomas kiest voor woensdag 10 januari van 14:00 – 15:00 uur. Dit verzoek gaat via zijn persoonlijke gezondheidsomgeving naar het ziekenhuisinformatiesysteem, dat de ontvangst van dit verzoek bevestigt. De afspraak is door Thomas te raadplegen via zijn persoonlijke gezondheidsomgeving.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Een persoonlijke gezondheidsomgeving kan achterhalen welk type afspraken het verbonden XIS ondersteunt: dit betreft het raadplegen van typen afspraken. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan voor een bepaalde periode én een bepaald type afspraak de beschikbare tijden ophalen uit het XIS. Dit betreft het raadplegen van beschikbare afspraak slots. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan - op basis van beschikbare slots - een verzoek tot het maken van een concrete afspraak doen aan het XIS. Een XIS kan een dergelijk afspraakverzoek wel/niet in behandeling nemen en stuurt daarvan een bevestiging.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch maken van afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil bepaalde typen afspraken maken en de zorgaanbieder ondersteunt het maken van deze afspraken.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare typen afspraken die gemaakt kunnen worden bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de typen afspraken.
*Het systeem van de patiënt (PGO) vraagt om beschikbare slots voor een bepaald type afspraak in een bepaalde tijdsperiode bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de beschikbare afspraak slots op basis van de filter criteria uit de persoonlijke gezondheidsomgeving.
*Het systeem van de patiënt (PGO) stuurt een verzoek om een bepaald type afspraak te maken in een bepaalde slot.
*Het systeem van de zorgaanbieder (XIS) ontvangt het afspraakverzoek en geeft een technisch antwoord. Het antwoord geeft aan of het verzoek wel of niet in behandeling genomen kan worden.

Indien een verzoek in behandeling genomen kan worden door XIS, dan kan verwerking enige tijd vergen. Het verzoek wordt niet altijd direct afgehandeld.

Bij een eventueel negatief antwoord van het XIS kan een patiënt ervoor kiezen het opnieuw proberen, bijvoorbeeld met een ander (opnieuw opgevraagd) slot.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een afspraakverzoek.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="3"| PGO
| style="background-color: white;"| AfspraakTypenRaadplegend
| style="background-color: white;"| EA-1.0.0-ATR-FHIR
| style="background-color: white;"| Raadplegen afspraak typen bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakSlotsRaadplegend
| style="background-color: white;"| EA-1.0.0-ASR-FHIR
| style="background-color: white;"| Raadplegen afspraak slots bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakverzoekSturend
| style="background-color: white;"| EA-1.0.0-AVS-FHIR
| style="background-color: white;"| Sturen afspraakverzoek naar zorgaanbieder
|-
| style="background-color: white;" rowspan="3"| XIS
| style="background-color: white;"| AfspraakTypenBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ATB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak typen
|-
| style="background-color: white;"| AfspraakSlotsBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ASB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak slots
|-
| style="background-color: white;"| AfspraakverzoekOntvangend
| style="background-color: white;"| EA-1.0.0-AVO-FHIR
| style="background-color: white;"| Ontvangen afspraakverzoek van de patient
|-
|}
Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak maken (Totaal).png|Componenten diagram afspraak maken]]

'''Componenten diagram afspraak maken'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakSlots (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="6"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakVerzoek (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraakverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AVS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraakverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AVO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak maken.png|Use case diagram afspraak maken]]

'''Use case diagram afspraak maken

==Use case: Afspraak annuleren door patiënt==
===Doel en relevantie===
Inzicht in afspraken biedt patiënten overzicht en gebruiksgemak. Dat is een functionaliteit die voorwaardelijk is voor deze use case: 'annuleren van afspraken'. Een patiënt is verder geholpen door ook afspraken te kunnen annuleren vanuit een persoonlijke gezondheidsomgeving. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het kunnen annuleren van een afspraak vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn gedefinieerd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
Sturen afspraak annulering
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
Ontvangen afspraak annulering
|}
'''Bedrijfsrollen afspraken inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak annuleren.png|Activiteitendiagram afspraak annuleren]]

'''Activiteitendiagram afspraak annuleren'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het annuleren van afspraken een rol speelt.

<blockquote>Thomas verhuist halverwege oktober 2017 voor zijn afstuderen naar Groningen. De afspraak voor de driemaandelijkse controle was al gemaakt in Rotterdam voor vrijdag 5 januari 2018. Thomas wil nu die afspraak afzeggen omdat hij die dag bezet is vanwege zijn afstudeerstage. Een nieuwe afspraak maakt hij liever in Groningen, dat is voor hem nu veel handiger.
Hij gebruikt zijn PGO om een verzoek te doen de afspraak in Rotterdam te annuleren. Een aantal uren later bevestigt de medisch secretaresse deze annulering. Thomas kan de afspraken weer raadplegen via zijn PGO.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Een persoonlijke gezondheidsomgeving kan achterhalen welk afspraken het verbonden XIS heeft voor de patiënt. Dit betreft het raadplegen van afspraken. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan voor een bestaande afspraak een verzoek doen tot annulering. Een XIS ontvangt, behandelt en beantwoordt een dergelijk verzoek.

Een PGO heeft afspraken geraadpleegd en opvolging verzoek beoordeeld. Mocht het verzoek niet verwerkt zijn, kan een patiënt ervoor kiezen het opnieuw te proberen, of op een andere manier de zorgaanbieder te benaderen. Indien het verzoek verwerkt is, stelt XIS bij raadpleging door PGO de afspraak met status ‘geannuleerd’ beschikbaar.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van informatie over afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil bepaalde afspraken kunnen annuleren en de zorgaanbieder ondersteunt dit.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) raadpleegt de beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Het systeem van de patiënt (PGO) stuurt een verzoek om de bestaande afspraak te annuleren.
*Het systeem van de zorgaanbieder (XIS) ontvangt de annulering en geeft een technisch antwoord. Het antwoord kan positief of negatief zijn voor het doorvoeren van de annulering.
*Het systeem van de patiënt (PGO) raadpleegt de beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken (waaronder de geannuleerde afspraak met status 'geannuleerd') op voor de patiënt.

Indien het verzoek verwerkt kan worden, stelt XIS de afspraak met status 'geannuleerd' beschikbaar, na raadpleging door patiënt vanuit zijn PGO.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een verzoek tot annulering van een afspraak.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="2"| PGO
| style="background-color: white;"| AfsprakenRaadplegend
| style="background-color: white;"| EA-1.0.0-AFR-FHIR
| style="background-color: white;"| Raadplegen afspraken bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakAnnuleringSturend
| style="background-color: white;"| EA-1.0.0-AAS-FHIR
| style="background-color: white;"| Sturen afspraak annulering naar de zorgaanbieder
|-
| style="background-color: white;" rowspan="2"| XIS
| style="background-color: white;"| AfsprakenBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraken aan de patiënt
|-
| style="background-color: white;"| AfspraakAnnuleringOntvangend
| style="background-color: white;"| EA-1.0.0-AAO-FHIR
| style="background-color: white;"| Ontvangen afspraak annulering van de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak annuleren (Totaal).png |Componenten diagram afspraak annuleren]]

'''Componenten diagram afspraak annuleren'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="4"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakAnnulering (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraak annulering
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AAS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraak annulering
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AAO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak annuleren.png |Use case diagram afspraak annuleren]]

'''Use case diagram afspraak annuleren

==Use case: Afspraak wijzigen door patiënt==
===Doel en relevantie===
Inzicht in en het maken van afspraken biedt patiënten overzicht en gebruiksgemak. Dat zijn functionaliteiten die voorwaardelijk zijn voor deze use case: 'wijzigen van afspraken'. Een patiënt is verder geholpen door ook afspraken te kunnen wijzigen vanuit een persoonlijke gezondheidsomgeving. Een wijziging kan ook een annulering betreffen. Dit draagt verder bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het kunnen wijzigen van een afspraak vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn gedefinieerd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
Raadplegen afspraak typen

Raadplegen afspraak slots

Sturen afspraak wijzigingsverzoek
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
Beschikbaarstellen afspraak typen

Beschikbaarstellen afspraak slots

Ontvangen afspraak wijzigingsverzoek
|}
'''Bedrijfsrollen afspraken inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak wijzigen.png|Activiteitendiagram afspraak wijzigen]]

'''Activiteitendiagram afspraak wijzigen'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het wijzigen van afspraken een rol speelt.

<blockquote>In de loop van december krijgt Thomas een buitenkansje. Een aantal van zijn vrienden gaan met skivakantie van zaterdag 5 t/m 12 januari en er is een plekje vrijgekomen. Voor een zacht prijsje kan hij mee. Daar heeft hij veel zin in!

Thomas zet de skivakantie ‘s avonds laat in zijn agenda en ziet dat dit conflicteert met zijn controle-afspraak in het Noorderziekenhuis op 10 januari. Hij moet die afspraak gaan verzetten. Het is 23:15 en dus te laat om het ziekenhuis hiervoor direct te bellen.

Via zijn PGO kijkt hij daarom naar beschikbare tijden in de derde week van januari. Er blijkt gelukkig nog een gaatje te zijn op vrijdag 19 januari om 11:30 – 12:30. Het verzoek om te wijzigen gaat via zijn PGO naar het ZIS, dat de ontvangst van het verzoek bevestigt. Bij raadpleging van de afspraken vanuit PGO, stelt XIS de nieuwe afspraak beschikbaar, alsmede de oorspronkelijke afspraak met status ‘ geannuleerd’.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Het systeem van een zorgaanbieder (XIS) stelt afspraken beschikbaar aan het systeem van een patiënt (PGO).
*Een persoonlijke gezondheidsomgeving kan achterhalen welk type afspraken het verbonden XIS ondersteunt: dit betreft het raadplegen van typen afspraken. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan voor een bepaalde periode én een bepaald type afspraak de beschikbare tijden ophalen uit het XIS. Dit betreft het raadplegen van beschikbare afspraak slots. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan - op basis van beschikbare slots - een verzoek tot het wijzigen van een concrete afspraak doen aan het XIS. Een XIS kan een dergelijk afspraak wijzigingsverzoek behandelen en ontvangst van het verzoek bevestigen.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van informatie over afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil een afspraak wijzigen en de zorgaanbieder ondersteunt het wijzigen van afspraken.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om afspraken in te zien en er één te selecteren die hij wil wijzigen.
*Het systeem van de patiënt (PGO) vraagt om beschikbare typen afspraken die gemaakt kunnen worden bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de typen afspraken.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om beschikbare typen afspraken in te zien en er één te selecteren.
*Het systeem van de patiënt (PGO) vraagt om beschikbare slots voor een bepaald type afspraak in een bepaalde tijdsperiode bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de beschikbare afspraak slots op basis van de filter criteria uit de persoonlijke gezondheidsomgeving.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om beschikbare slots in te zien en er één te selecteren.
*Het systeem van de patiënt (PGO) stuurt een verzoek om de bestaande afspraak te wijzigen.
*Het systeem van de zorgaanbieder (XIS) ontvangt het afspraak wijzigingsverzoek en geeft een technisch antwoord. Het antwoord kan positief of negatief zijn voor de wijziging.

Patiënt raadpleegt opnieuw de afspraken vanuit zijn PGO + XIS stelt de nieuwe afspraak beschikbaar, alsmede de oorspronkelijke afspraak met status ‘geannuleerd’.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een afspraak wijzigingsverzoek.

Bij een eventueel negatief antwoord van het XIS kan een patiënt ervoor kiezen het opnieuw proberen, bijvoorbeeld met een ander (opnieuw opgevraagd) slot.
Bij een positief antwoord is de afspraak gewijzigd en inzichtelijk in zowel XIS als PGO.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="4"| PGO
| style="background-color: white;"| AfspraakRaadplegend
| style="background-color: white;"| EA-1.0.0-AFO-FHIR
| style="background-color: white;"| Raadplegen afspraak bij zorgaanbieder
|-
| style="background-color: white;"| AfspraakTypenRaadplegend
| style="background-color: white;"| EA-1.0.0-ATR-FHIR
| style="background-color: white;"| Raadplegen afspraak typen bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakSlotsRaadplegend
| style="background-color: white;"| EA-1.0.0-ASR-FHIR
| style="background-color: white;"| Raadplegen afspraak slots bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakWijzigingsverzoekSturend
| style="background-color: white;"| EA-1.0.0-AWS-FHIR
| style="background-color: white;"| Sturen afspraak wijzigingsverzoek
|-
| style="background-color: white;" rowspan="4"| XIS
| style="background-color: white;"| AfspraakBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak aan de patiënt
|-
| style="background-color: white;"| AfspraakTypenBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ATB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak typen
|-
| style="background-color: white;"| AfspraakSlotsBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ASB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak slots
|-
| style="background-color: white;"| AfspraakWijzigingsverzoekOntvangend
| style="background-color: white;"| EA-1.0.0-AWO-FHIR
| style="background-color: white;"| Ontvangen afspraak wijzigingsverzoek van de patiënt.
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak wijzigen (Totaal).png|Componenten diagram afspraak wijzigen]]

'''Componenten diagram afspraak wijzigen'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="8"|[[MedMij:V2018.04_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakSlots (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakTypen (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak typen
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ATR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak typen
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ATB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakWijziging (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraak wijzigingsverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AWS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraak wijzigingsverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AWO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak wijzigen.png|Use case diagram afspraak wijzigen]]

'''Use case diagram afspraak wijzigen

=Functionaliteit=
-

=Verantwoordelijkheid voor informatie=
Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

=Infrastructuur=
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| AUTEUR(S)
| style="background-color: white;"| TITEL
| style="background-color: white;"| VERSIE
| style="background-color: white;"| DATUM
| style="background-color: white;"| BRON
| style="background-color: white;"| ORGANISATIE
|}
'''Referenties

MedMij:V2018.04 FHIR GP Data

2018-08-30T12:58:02Z

Marten Smits:

{{#customtitle:MedMij FHIR use case GP Patient Data}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:Huisartsgegevens.png |link=|links|90px|Use case GP Patient Data|GP Patient Data]]
<imagemap>Bestand:Leeswijzer-technisch-banner 03 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.04_OntwerpHuisartsgegevens|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.04_FHIR_IG|Technisch]]
desc none
</imagemap>

__TOC__

==Introduction==
[[Bestand:Functioneel-02.png|link=MedMij:V2018.04_Ontwerpen |100px|rechts|Functional design|Go to functional design]]

The input document "[[MedMij:V2018.04_OntwerpHuisartsgegevens#richtlijn-huisarts-patient|Richtlijn online inzage in het H-EPD door patiënt]]" (Dutch) described online access of GP data by patients. The use case evolves around a GP specific Patient Data that consists of 10 sections plus the patient and the healthcare provider (GP). These sections correspond to the "[[MedMij:V2018.04_OntwerpHuisartsgegevens#his-referentiemodel-2016|HIS referentiemodel Publieksversie 2016]]" (Dutch). ''HIS referentiemodel'' is the GP information system reference model (GP-IS-RM).

Some but not all sections in the GP Patient Data correspond to Health and Care Information Models ([https://zibs.nl/wiki/HCIM_Mainpage HCIMs] (English) or [https://zibs.nl/wiki/ZIB_Hoofdpagina ZIBs] (Dutch)). A joint initiative project between [http://www.nictiz.nl Nictiz] and the Dutch GP association [https://www.nhg.org NHG] is underway to analyse the relationship between the GP-IS-RM and the HCIMs and propose updates where needed. This analysis will not yield results before 2019. This specification thus predates the analysis, and will updated accordingly moving forward.

This page will elaborate further on the HL7 FHIR details needed to exchange the GP Patient Data information using FHIR.

==Actors involved==
{| class="wikitable"
! colspan="2" style="text-align:left;" | Persons
! colspan="2" style="text-align:left;" | Systems
! colspan="2" style="text-align:left;" | FHIR Capability Statements
|-
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
|-
| Patient
| The user of a personal healthcare enviorment.
| PHR
| Personal health record
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/NictizSTU3-Zib2017/gp-patientdata2017-clientcapabilities CapabilityStatement: Client]
| GP Patient Data client requirements
|-
| Healthcare professional
| The user of a XIS
| XIS
| Healthcare information system
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/NictizSTU3-Zib2017/gp-patientdata2017-servercapabilities CapabilityStatement: Server]
| GP Patient Data server requirements
|}

==Boundaries and Relationships==
The GP Patient Data use case has similarities and differences with other use cases such as the [[MedMij:Vcurrent_FHIR_IG|BgZ]], Medication Process, Vital Signs and Lab Results. These use cases use much of the same HCIM based FHIR profiles for exchanging information. Wherever possible every attempt is made to re-use the profiles as used in the BgZ. The GP Patient Data also has a few unique profiles compared to the aforementioned use cases. A second thing to note is that while the selection criteria of certain sections like lab do not match, this does not affect the response profiles. For example it is irrelevant for the response profile lab if you request the 'latest lab result' or 'every result since date X'.

==List of invocations==
[[Bestand:Afsprakenstelsel-01.png|link=https://www.medmij.nl/afsprakenstelsel/|rechts |100px|Go to Afsprakenstelsel]]

This FHIR implementation guide assumes that the PHR system is able to make a connection to the XIS that contains the GP Patient Data information. It does not provide information on finding the right XIS nor does it provide information about security. These infrastructure and interface specifications are described in the [https://www.medmij.nl/afsprakenstelsel/ 'Afsprakenstelsel'].

===Client - PHR===
The PHR system can request the GP Patient Data using individual search interactions. The search interaction searches the current resources based on some filter criteria. The interaction can be performed by an HTTP GET or command as shown:

<code>GET [base]/[type]/{?[parameters]{&_format=[mime-type]}}</code>

The table below shows in the first four columns the GP Patient Data sections, the GP-IS-RM sections / HCIMs that constitute those sections and the specific content of the GP Patient Data. The last column shows the FHIR search queries to obtain the GP Patient Data information. These queries are based on StructureDefinitions listed in [[#List_of_StructureDefinitions| this section]]. As noted in the [[#Introduction|introduction]], the associated HCIMs are ahead of a separate joint initiative project that aims to analyse and harmonize this further.

Each query is performed in the context of a specific authenticated patient, for which an OAuth2 token has been retrieved using the Authentication mechanisms described in the [https://www.medmij.nl/afsprakenstelsel/ 'Afsprakenstelsel']. This token must be passed in each call in the HTTP header named “Authorization”. Each XIS Gateway is required to perform filtering based on the patient associated with the OAuth2 token received for the request, so that only the records associated with the authenticated patient are returned. Therefore, no search parameters should be passed for patient identification.

{| class="wikitable collapsible" cellpadding="10"
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="6" | Bijlage 1 Richtlijn Online inzage in het H-EPD door patiënt
|-
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| #
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| GP Patient Data Section
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| HCIM EN
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| Content
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| Example search URL
|-
| style="background-color: white;vertical-align:top;"| 1
| style="background-color: white;vertical-align:top;"| General Practitioner/Practice
| style="background-color: white;vertical-align:top;"| [https://zibs.nl/wiki/HealthProfessional-v3.1(2017EN) HealthProfessional v3.1 (2017)] [https://zibs.nl/wiki/HealthcareProvider-v3.1(2017EN) HealthcareProvider v3.1 (2017)]
| style="background-color: white;vertical-align:top;"| The GP or GP practice that originates the patient data.
| style="background-color: white;vertical-align:top;"| ''TODO. Check assumption here that a patient requests the data from his regular GP. If he were to request it from any other GP/practice he might have visited, then the Patient.generalPractitioner does not apply.''<pre style="font-style: italic;">see Patient</pre>
|-
| style="vertical-align:top;"| 2
| style="vertical-align:top;"| Patient
| style="vertical-align:top;"| [https://zibs.nl/wiki/Patient-v3.1(2017EN) Patient v3.1 (2017)]
| style="vertical-align:top;"| De patient data of the patient the data is for.
| style="vertical-align:top;"| <pre>GET [base]/Patient?_include=Patient:general-practitioner</pre>
|-
| style="background-color: white;vertical-align:top;"| 3
| style="background-color: white;vertical-align:top;"| Episodes
| style="background-color: white;" rowspan="3"|
| style="background-color: white;vertical-align:top;"| A health concern like a complaint of illness, that may change in nature as diagnoses are made and/or the illness develops.
| style="background-color: white;" rowspan="3"| <pre>GET [base]/EpisodeOfCare?_revinclude=Flag:detail</pre>
|-
| style="vertical-align:top;"| 4
| style="vertical-align:top;"| Episodes with alert flag
| style="vertical-align:top;"| Episodes may have an associated alert signaling extra attention to the episode is requested. The alert flag may stay active even if after closing the episode, if the user deems it important to stay aware.
|-
| style="background-color: white;vertical-align:top;"| 5
| style="background-color: white;vertical-align:top;"| Open and closed episodes
| style="background-color: white;vertical-align:top;"| Episodes may be open (currently active) or closed (no longer active).
|- style="vertical-align:top;"
| 6
| Treatment
| ''[https://zibs.nl/wiki/Procedure-v4.0(2017EN) Procedure v4.0 (2017)]''
| Procedure on the patient targeting the patients health situation. E.g. operative and (severe) procedures like radiation or chemotherapy.
| <pre>GET [base]/Procedure?category=http://snomed.info/sct|365508006</pre>
|-
| style="background-color: white;vertical-align:top;"| 7
| style="background-color: white;vertical-align:top;"| Prophylaxis en precaution
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"| Prophylaxis and precaution contain precautionary measures required for or to prevent certain medical conditions. See [https://referentiemodel.nhg.org/tabellen/894/publieksversie/published NHG Tabel 56]
| style="background-color: white;vertical-align:top;"| ''TODO: No HCIM. GP systems do not yet export this info. Unclear if it'll be anything beyond the Table 56 code (id, time, author, text?)'' <pre>GET [base]/Observation?code=https://referentiemodel.nhg.org/tabellen/nhg-tabel-56-profylaxe-en-voorzorg|</pre>
|-
| style="vertical-align:top;"| 8
| style="vertical-align:top;"|Current medication
| style="vertical-align:top;"|[https://zibs.nl/wiki/MedicationAgreement-v1.0(2017EN) MedicationAgreement v1.0 (2017)]
| style="vertical-align:top;"|MedicationAgreement The prescriber proposed use of medication that the patient agrees with. The agreement may signal starting, repeating, updating or stopping the medication. The list of MedicationAgreements is also known as the list of medication the patient is '''currently''' using
| style="vertical-align:top;"|<pre>GET [base]/MedicationRequest?status=active&category=http://snomed.info/sct|16076005&_include:MedicationRequest:medication</pre>
|-
| style="background-color: white;vertical-align:top;"| 9
| style="background-color: white;vertical-align:top;"|Medication intolerance
| style="background-color: white;vertical-align:top;"| [https://zibs.nl/wiki/AllergyIntolerance-v3.1(2017EN) AllergyIntolerance v3.1 (2017)]
| style="background-color: white;vertical-align:top;"|A medication intolerance concerns the intolerance of a patient for a specific drug, substance or substance group, that needs to be taken into account when prescribing, dispensing or administering medication.
| style="background-color: white;vertical-align:top;"| <pre>GET [base]/AllergyIntolerance</pre>
|-
| style="vertical-align:top;"| 10
| style="vertical-align:top;"| Correspondence
| style="vertical-align:top;"| ''[https://zibs.nl/wiki/TextResult-v4.0(2017EN) TextResult v4.0 (2017)]''
| style="vertical-align:top;"|Incoming: an incoming letter about a patient, recorded as such in the patients medical record. Outbound: a letter created by a healthcare professional for a third party healthcare professional.
| style="vertical-align:top;"| ''TODO: HCIM is a poor match. GP systems do not yet export this info. FHIR DocumentReference is a very good match though'' <pre>GET [base]/DocumentReference</pre>
|-
| style="background-color: white;vertical-align:top;" rowspan="9"| 11
| style="background-color: white;vertical-align:top;" rowspan="9"| Lab results
| style="background-color: white;vertical-align:top;"| [https://zibs.nl/wiki/LaboratoryTestResult-v4.0(2017EN) LaboratoryTestResult v4.0 (2017)]
| style="background-color: white;vertical-align:top;" rowspan="9"|A lab test is an objectifiable diagnostic procedure. The result is the outcome of the procedure. Lab tests include vital signs like blood pressure, weight and lab results like ferro in blood. Note that GP (lab) results are normally coded using [https://referentiemodel.nhg.org/tabellen/nhg-tabel-45-diagnostische-bepalingen NHG Tabel 45]. While some of these codes might be convertible to LOINC or SNOMED CT, this is '''not''' expected at present. Bridging code systems between primary and secondary care is part of a larger national discussion Note that the date parameter is optional and needs calculation, e.g. current-date() - 14 months. The business rules in the [[MedMij:V2018.04_OntwerpHuisartsPatientsamenvatting#richtlijn-huisarts-patient|guide lines]] determine the maximum range for the returned results. If the date parameter is omitted, the maximum range is assumed
| style="background-color: white;" rowspan="9"| <pre>GET [base]/Observation?code=https://referentiemodel.nhg.org/tabellen/nhg-tabel-45-diagnostische-bepalingen|&_include=Observation:related-target&_include=Observation:specimen&date=ge2017-01-01</pre>
|-
| style="background-color: white;vertical-align:top;"| [https://zibs.nl/wiki/BloodPressure-v3.1(2017EN) BloodPressure v3.1 (2017)]
|-
| style="background-color: white;vertical-align:top;"| [https://zibs.nl/wiki/BodyHeight-v3.1(2017EN) BodyHeight v3.1 (2017)]
|-
| style="background-color: white;vertical-align:top;"| [https://zibs.nl/wiki/BodyTemperature-v3.1(2017EN) BodyTemperature v3.1 (2017)]
|-
| style="background-color: white;vertical-align:top;"| [https://zibs.nl/wiki/BodyWeight-v3.1(2017EN) BodyWeight v3.1 (2017)]
|-
| style="background-color: white;vertical-align:top;"| [https://zibs.nl/wiki/GeneralMeasurement-v3.0(2017EN) GeneralMeasurement v3.0 (2017)]
|-
| style="background-color: white;vertical-align:top;"| [https://zibs.nl/wiki/HeartRate-v3.1(2017EN) HeartRate v3.1 (2017)]
|-
| style="background-color: white;vertical-align:top;"| [https://zibs.nl/wiki/O2Saturation-v3.1(2017EN) O2Saturation v3.1(2017)]
|-
| style="background-color: white;vertical-align:top;"| [https://zibs.nl/wiki/PulseRate-v3.1(2017EN) PulseRate v3.1(2017)]
|- style="vertical-align:top;"
| 12
|E- and P-journal entries of the SOAP (EN) or SOEP (NL) structure - ''recorded after introduction of online access''
| ''[https://zibs.nl/wiki/TextResult-v4.0(2017EN) TextResult v4.0 (2017)]''
| Information from an encounter, recorded in free text using the SOAP structure. The acronym SOAP stands for Subjective, Objective, Assessment and Plan. The E entry contains the consultation conclusion and the P entry contains potential next steps. Note that the profile for SOAP entries is yet to be created and the code system value is preliminary
| ''TODO: LOINC code has status proposal'' <pre>GET [base]/Composition?type=http://loinc.org|67781-5</pre>
|}

===Server - XIS===
Important sections of the FHIR specification for a server in this use case are the [http://hl7.org/fhir/STU3/http.html#2.21.0 RESTful API section] the [http://hl7.org/fhir/STU3/search.html search section] and [http://hl7.org/fhir/STU3/operations.html operation section] (for the nlast operation).

====Response to resource requests====
If the search succeeds, the server SHALL return a 200 OK HTTP status code and the return content SHALL be a Bundle with type = searchset containing the results of the search as a collection of zero or more resources in a defined order. The returned content should conform to the StructureDefinition applicable for the specific HCIM request. The list of a StructureDefinitions relevant for this use case is shown in the following paragraph: [[#List_of_StructureDefinitions| List of StructureDefinitions]]

The result collection can be long, so servers may use paging. If they do, they SHALL use the method described below (adapted from RFC 5005 (Feed Paging and Archiving ) for breaking the collection into pages if appropriate. The server MAY also return an [http://hl7.org/fhir/operationoutcome.html OperationOutcome resource] within the searchset Bundle entries that contains additional information about the search; if one is sent it SHALL NOT include any issues with a fatal or error severity, and it SHALL be marked with a Bundle.entry.search.mode of outcome.

In order to allow the client to be confident about what search parameters were used as criteria by the server, the server SHALL return the parameters that were actually used to process the search. Applications processing search results SHALL check these returned values where necessary. For example, if the server did not support some of the filters specified in the search, a client might manually apply those filters to the retrieved result set, display a warning message to the user or take some other action.

In the case of a RESTful search, these parameters are encoded in the self link in the bundle that is returned:
<pre>
<link>
<relation value="self"/>
<url value="http://example.org/Patient?identifier=[Patient-ID]/>
</link>
</pre>

Link to the relevant FHIR specification: http://hl7.org/fhir/STU3/http.html#search

====Handling errors====
If the search fails '''(cannot be executed, not that there are no matches)''', the return value is a status code 4xx or 5xx with an OperationOutcome. An HTTP status code of 403 signifies that the server refused to perform the search, while other 4xx and 5xx codes signify that some sort of error has occurred. The HTTP status code 404 is returned if a XIS did not implement an endpoint used in a request by a PHR. When the search fails, a server SHOULD return an OperationOutcome detailing the cause of the failure. For example, in case of a not implemented FHIR endpoint, the OperationOutcome would state that the resource type is not supported. Note: an empty search result is not a failure.

Common HTTP Status codes returned on FHIR-related errors (in addition to normal HTTP errors related to security, header and content type negotiation issues):

* 400 Bad Request - search could not be processed or failed basic FHIR validation rules
* 401 Not Authorized - authorization is required for the interaction that was attempted
* 404 Not Found - resource type not supported, or not a FHIR end-point

In some cases, parameters may cause an error. For instance:

* A parameter may refer to a non-existent resource e.g. <code>GET [base]/Observation?subject=101</code>, where "101" does not exist
* A parameter may refer to an unknown code e.g. <code>GET [base]/Observation?code=loinc|1234-1</code>, where the LOINC code "1234-1" is not known to the server
* A parameter may refer to a time that is out of scope e.g. <code>GET [base]/Condition?onset=le1995</code>, where the system only has data going back to 2001
* A parameter may use an illegal or unacceptable modifier e.g. <code>GET [base]/Condition?onset:text=1995</code>, where the modifier cannot be processed by the server
* A data time parameter may have incorrect format e.g. <code>GET [base]/Condition?onset=23%20May%202009</code>
* A parameter may be unknown or unsupported
Where the content of the parameter is syntactically incorrect, servers SHOULD return an error. However, where the issue is a logical condition (e.g. unknown subject or code), the server SHOULD process the search, including processing the parameter - with the result of returning an empty search set, since the parameter cannot be satisfied.

In such cases, the search process MAY include an OperationOutcome in the search set that contains additional hints and warnings about the search process. This is included in the search results as an entry with search mode = outcome. Clients can use this information to improve future searches.

Link to relevant FHIR specification: http://hl7.org/fhir/STU3/search.html#errors

==Interactions, operations, search parameters==

===Interactions===

The following logical interactions are needed for the GP Patient Data use case:
* [http://hl7.org/fhir/STU3/http.html#search Search]
* [http://hl7.org/fhir/STU3/http.html#transaction Batch/Transaction]

===Operations===
There are no operations required to support this use case

===Search parameters===
The following search parameter types and search result parameters need to be supported for this use case.

Search parameter types:


Search result parameters:
* [http://hl7.org/fhir/STU3/search.html#include _include]
* [http://hl7.org/fhir/STU3/search.html#include _revinclude]

==List of StructureDefinitions==
The profiles represent their entire respective HCIM, to make them applicable in a broader context than the exchange of GP Patient Data or a MedMij context. An example for reuse of existing profiles are those of the patient administration resources and vital signs.

{| class="wikitable collapsible" cellpadding="10"
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="6" | Bijlage 1 Richtlijn Online inzage in het H-EPD door patiënt
|-
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | Section
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:100px" | ZIB NL
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:100px" | HCIM EN
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:100px" | FHIR Resource
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:400px" | URL Profile
|-
| style="background-color: white;" rowspan="2"| 1
| style="background-color: white;"| Zorgverlener
| style="background-color: white;"| HealthProfessional
| style="background-color: white;"|
| style="background-color: white;"| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
|-
| style="background-color: white;"| Zorgaanbieder
| style="background-color: white;"| HealthcareProvider
| style="background-color: white;"| Organization
| style="background-color: white;"| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
|-
| 2
|Patiënt
|Patient
| Patient
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
|-
| style="background-color: white;"| 3
| style="background-color: white;" rowspan="3"|
| style="background-color: white;" rowspan="3"|
| style="background-color: white;" rowspan="3"| EpisodeOfCare
| style="background-color: white;" rowspan="3"| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-episodeofcare http://fhir.nl/fhir/StructureDefinition/nl-core-episodeofcare]
|-
| 4
|-
| style="background-color: white;"| 5
|-
| 6
|Procedure
|Verrichting
| Procedure
| [https://simplifier.net/NictizSTU3-Zib2017/zib-Procedure http://nictiz.nl/fhir/StructureDefinition/zib-Procedure]
|-
| style="background-color: white;"| 7
| style="background-color: white;"| AlgemeneMeting
| style="background-color: white;"| GeneralMeasurement
| style="background-color: white;"|
| style="background-color: white;"|
|-
| 8
| MedicatieAfspraak
| MedicationAgreement
| MedicationRequest
| [https://simplifier.net/NictizSTU3-Zib2017/zib-MedicationAgreement http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAgreement]
|-
| style="background-color: white;"| 9
| style="background-color: white;"| AllergieIntolerantie
| style="background-color: white;"| AllergyIntolerance
| style="background-color: white;"| AllergyIntolerance
| style="background-color: white;"| [https://simplifier.net/NictizSTU3-Zib2017/zib-AllergyIntolerance http://nictiz.nl/fhir/StructureDefinition/zib-AllergyIntolerance]
|-
| 10
| ''Correspondentie''
|
| DocumentReference
| [https://simplifier.net/IHEPatientDemographi/IHEMHDDocumentReference http://ihe.net/fhir/StructureDefinition/IHE.MHD.DocumentReference]
|-
| style="background-color: white;" rowspan="9"| 11
| style="background-color: white;"| LaboratoriumUitslag
| style="background-color: white;"| LaboratoryTestResult
| style="background-color: white;" rowspan="9"| Observation
| style="background-color: white;" rowspan="9"| [https://simplifier.net/NictizSTU3-Zib2017/gp-DiagnosticResult http://nictiz.nl/fhir/StructureDefinition/gp-DiagnosticResult] (NHG Table 45 codes of type D) [https://simplifier.net/NictizSTU3-Zib2017/gp-LaboratoryResult http://nictiz.nl/fhir/StructureDefinition/gp-LaboratoryResult] (NHG Table 45 codes of type L)
|-
| style="background-color: white;"| Bloeddruk
| style="background-color: white;"| BloodPressure
|-
| style="background-color: white;"| Lichaamslengte
| style="background-color: white;"| BodyHeight
|-
| style="background-color: white;"| Lichaamstemperatuur
| style="background-color: white;"| BodyTemperature
|-
| style="background-color: white;"| Lichaamsgewicht
| style="background-color: white;"| BodyWeight
|-
| style="background-color: white;"| AlgemeneMeting
| style="background-color: white;"| GeneralMeasurement
|-
| style="background-color: white;"| Harfrequentie
| style="background-color: white;"| HeartRate
|-
| style="background-color: white;"| O2Saturatie
| style="background-color: white;"| O2Saturation
|-
| style="background-color: white;"| Polsfrequentie
| style="background-color: white;"| PulseRate
|-
| 12
| ''E and P entry from SOAP/SOEP''
|
| Composition Observation
| [https://simplifier.net/NictizSTU3-Zib2017/gp-EncounterReport http://nictiz.nl/fhir/StructureDefinition/gp-EncounterReport] [https://simplifier.net/NictizSTU3-Zib2017/gp-JournalEntry http://nictiz.nl/fhir/StructureDefinition/gp-JournalEntry]
|}

==Terminology, NamingSystems, Mappings==

===Terminology===
Relevant value sets can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=ValueSet here]. All resources can be downloaded in a .zip in XML or JSON format. In the .zip, the value sets are stored in the directory 'value sets'.

===NamingSystems===
Relevant NamingSystems can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=NamingSystem here].

===Mappings===
Relevant ZIB to FHIR value set mappings can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=ConceptMap here].
All profiles include HCIM mappings. HCIM concepts are mapped in the corresponding FHIR elements using the HCIMs concept id. The top of the StructureDefinition contains meta information regarding the HCIM mapping, such as the name and uri of the HCIM. In the StructureDefinition elements the corresponding HCIM ID is given including the mapping meta information id. This is illustrated in the following example.

<pre>
<StructureDefinition>
<id value="nl-core-patient" />
.....
<mapping>
<identity value="hcim-patient-v3.1-2017EN"/>
<uri value="https://zibs.nl/wiki/Patient-v3.1(2017EN)"/>
<name value="HCIM Patient-v3.1(2017EN)"/>
</mapping>
.....
<element id="Patient.name">
<path value="Patient.name" />
<short value="NameInformation" />
<alias value="Naamgegevens" />
<type>
<code value="HumanName" />
<profile value="http://fhir.nl/fhir/StructureDefinition/nl-core-humanname" />
</type>
<mapping>
<identity value="hcim-patient-v3.1-2017EN"/>
<map value="NL-CM:0.1.6"/>
</mapping>
</element>
.....
</StructureDefinition>
</pre>

[[Categorie:MedMij FHIR Use Cases]]

MedMij:V2018.04 FHIR PDFA

2018-08-30T12:57:38Z

Marten Smits:

{{#customtitle:MedMij FHIR use case PDF/A}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:PDF-A_icoon.png|link=|87px |links||PDF/A]]
<imagemap>Bestand:Leeswijzer-technisch-banner 03 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.04_OntwerpPDFA|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.04_FHIR_IG|Technisch]]
desc none
</imagemap>

__TOC__

=Introduction=
[[Bestand:Functioneel-02.png|link=MedMij:V2018.04_Ontwerpen |100px|rechts|Functional design|Go to functional design]]

MedMij specifies the format [http://www.pdfa.org/publication/pdfa-in-a-nutshell-2-0/ PDF/A] for exchanging unstructured documents containing health information. Forum Standaardisatie is a Dutch governmental organization that aims to stimulate the use of open standards. PDF/A is one of the standards that is recommended by Forum Standaardisatie. More information regarding PDF/A can be found here: https://www.forumstandaardisatie.nl/standaard/pdf-a1.

To achieve exchange of PDF/A files, MedMij adopts as much as possible from the Mobile access to Health Documents (MHD) profile from Integrating the Healthcare Enterprise (IHE) that defines a RESTful/HTTP interface to an [http://wiki.ihe.net/index.php/Cross-Enterprise_Document_Sharing XDS] environment using HL7 FHIR STU3 resources. The MHD profile is written to be content agnostic and as such is suitable for much more than PDF/A. For this use case, we have limited the scope to PDF/A.

MedMij includes the IHE MHD profile as a framework to exchange PDF/A documents. The next section summarizes MHD and contains references to this specification. The following section provides an adaptation of the MHD profile to specify exchange of PDF/A documents in a MedMij context. For example, the MHD actors and transactions are put into perspective of the MedMij actors and systems. The essence of the MHD profile is outlined and example transaction messages have been added.

'''Note''': this page is part of the [https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.04_FHIR_IG MedMij FHIR Implementation Guide] and is a technical representation of the functional design published on this [[MedMij:V2018.04_Ontwerpen| wiki page]].

=IHE MHD specification=
Mobile access to Health Documents (MHD) profile defines a simple HTTP interface to an XDS like environment. It describes four transactions:
# submit submission sets, folders, new documents, and document metadata from the mobile device to a document receiver (Provide Document Bundle),
# find submission sets matching query parameters (Find Document Manifest),
# find document entries containing metadata based on query parameters (Find Document Reference),
# retrieve a copy of a specific document (Retrieve Document).
These transactions leverage the document content and format agnostic metadata concepts from XDS but simplify them for access by constrained environments such as mobile devices, or other resource-constrained systems. The MHD profile does not replace XDS. It can be used to allow mobile devices, or other resource-constrained systems, access to an XDS health information exchange.[http://wiki.ihe.net/index.php/Mobile_access_to_Health_Documents_(MHD)]

'''Wiki:'''
[http://wiki.ihe.net/index.php/Mobile_access_to_Health_Documents_(MHD) Mobile acces to Health Document (MHD)]

'''Document:'''
[http://www.ihe.net/uploadedFiles/Documents/ITI/IHE_ITI_Suppl_MHD.pdf MHD Supplement] (Rev 2.3 July 24, 2017)

'''Additional Supplement:'''
[http://www.ihe.net/uploadedFiles/Documents/ITI/IHE_ITI_Suppl_Appx-Z.pdf Appendix Z on HL7 FHIR]

'''Underlying Standards:'''
* HL7 FHIR STU3 http://hl7.org/fhir/STU3
** [http://hl7.org/fhir/STU3/bundle.html Bundle]
** [http://hl7.org/fhir/STU3/documentmanifest.html DocumentManifest]
** [http://hl7.org/fhir/STU3/documentreference.html DocumentReference]
** [http://hl7.org/fhir/STU3/binary.html Binary]
** [http://hl7.org/fhir/STU3/list.html List]
** [http://hl7.org/fhir/STU3/operationoutcome.html OperationOutcome]
** [http://hl7.org/fhir/STU3/patient.html Patient]
** [http://hl7.org/fhir/STU3/practitioner.html Practitioner]
* RFC2616 IETF Hypertext Transfer Protocol – HTTP/1.1
* RFC3986 IETF Uniform Resource Identifier (URI): Generic Syntax
* RFC4627 The application/json Media Type for JavaScript Object Notation (JSON)
* RFC6585 IETF Additional HTTP Status Codes

=Exchanging PDF/A documents=
[[Bestand:Afsprakenstelsel-01.png|link=https://www.medmij.nl/afsprakenstelsel/|rechts |100px|Go to Afsprakenstelsel]]
This section summarizes the IHE MHD profile to exchange PDF/A documents in a MedMij context.

{{FHIR-IG-Afsprakenstelsel-Note}}

==Actors and transactions involved==
Table 1 shows the relevant actors, systems and FHIR capability statements in a MedMij context. The capability statements demonstrate the minimum requirements to be conformant to the full MHD specifications.
{| class="wikitable"
! colspan="2" style="text-align:left;" | Persons
! colspan="2" style="text-align:left;" | Systems
! colspan="2" style="text-align:left;" | FHIR Capability Statements
|-
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
|-
| Patient
| The user of a personal healthcare environment.
| PHR
| Personal health record
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/NictizSTU3/pdfa-clientcapabilities CapabilityStatement: Client]
| PDFA FHIR Client requirements
|-
| Healthcare Provider
| The user of a XIS
| XIS
| Healthcare information system
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/NictizSTU3/pdfa-servercapabilities CapabilityStatement: Server]
| PDFA FHIR Server requirements
|}
'''Table 1. Actors, systems and FHIR capability statements'''

Table 2 shows the MHD actors and transactions in perspective of the systems used in a MedMij context.
{| class="wikitable"
! style="font-weight: bold; text-align:left;" | Person
! style="font-weight: bold; text-align:left;" | System
! style="font-weight: bold; text-align:left;" | MHD Actors
! style="font-weight: bold; text-align:left;" | MHD Transactions
|-
| rowspan="5" | Patient
|-
| rowspan="4" | PHR
|-
| rowspan="3" | Document Consumer
| Find Document Manifest
|-
| Find Document Reference
|-
| Retrieve Document
|-
| rowspan="5" | Healthcare provider
|-
| rowspan="4" | XIS
|-
| rowspan="3" | Document Responder
| Find Document Manifest
|-
| Find Document Reference
|-
| Retrieve Document
|}
'''Table 2. MHD actors and transactions in perspective of systems in a MedMij context'''

===Transactions in scope===

* Find Document Manifests – This transaction is used to issue parameterized queries that result in a list of Document Manifest resources.
* Find Document References – This transaction is used to issue parameterized queries that produce a list of Document Reference resources.
* Retrieve Document – This transaction is used to get documents.

Document Consumer shall implement at least one transaction: Find Document Manifests, Find Document References, or Retrieve Document. Document Responder shall implement all transactions.

===Transactions out of scope===
The MHD profile specifies how to send documents from a Document Source to a Document Receiver using the Provide Document Bundle transaction. However, sending PDF/A documents is currently out of scope for the MedMij context. The 'Afsprakenstelsel' first focuses on pulling data from a XIS to a PHR before considering push transactions. In the future, specifications of sending PDF/A documents from a PHR will be added.

==Find and retrieve existing PDF/A document(s)==

===Find PDF/A or PDF/A collection===
Discovery of PDF/A documents is done with the MHD defined transaction 'Find Document Reference' or 'Find Document Manifest.' The Find Document Reference retrieves FHIR DocumentReference Resources that represents a single reference to document per resource, for example, one PDF/A file. The Find Document Manifest retrieves FHIR DocumentManifest Resources. A DocumentManifest Resource gathers a set of DocumentReference Resources into a single package together with metadata that applies to the collection.

The Document Consumer requests DocumentReference or DocumentManifest Resources, matching a set of criteria, from the Document Responder. The Document Responder returns DocumentReference or DocumentManifest Resources that match the search criteria provided by the Document Consumer.

====Request message====
'''Search'''

The Document Consumer executes an HTTP GET conform to the FHIR [http://hl7.org/fhir/http.html RESTfull] and [http://hl7.org/fhir/search.html search] specification. A search query would have the following format.

<pre>
GET [base]DocumentReference?[parameters]{&_format=[mime-type]}
GET [base]DocumentManifest?[parameters]{&_format=[mime-type]}
</pre>

Example query to search for DocumentReferences of type Discharge summary with a current status.
<pre>GET http://example.org/fhir/DocumentReference?type=http://loinc.org|18842-5&status=current</pre>

'''Search Parameters'''
The Document Consumer shall include search parameter status. The Document Consumer may supply, and the Document Responder shall be capable of processing, all query parameters listed below. These search parameters are a selection of the defined search parameters by the HL7 FHIR specification (search parameters: [http://hl7.org/fhir/STU3/documentreference.html#search DocumentReference], [http://hl7.org/fhir/STU3/documentmanifest.html#search DocumentManifest]). See also the HL7 FHIR STU3 specification for [http://www.hl7.org/fhir/STU3/search.html searching].
{| class="wikitable"
! colspan="3" style="font-weight: bold; text-align:left;" | DocumentReference
! colspan="3" style="font-weight: bold; text-align:left;" | DocumentManifest
|-
| style="font-weight: bold;" | Name
| style="font-weight: bold;" | Type
| style="font-weight: bold;" | Description
| style="font-weight: bold;" | Name
| style="font-weight: bold;" | Type
| style="font-weight: bold;" | Description
|-
| indexed
| date
| When this document reference was created
| created
| date
| When this document manifest created
|-
| author (author.given and author.family)
| string
| Who and/or what authored the document
| author (author.given and author.family)
| string
| Who and/or what authored the manifest
|-
| type
| token
| Kind of document (LOINC if possible)
| type
| token
| Kind of document set
|-
| class
| token
| Categorization of document
| source
| uri
| The source system/application/software
|-
| status
| token
| current / superseded
| status
| token
| current / superseded
|-
| setting
| token
| Additional details about where the content was created (e.g. clinical specialty)
|
|
|
|-
| period
| date
| Time of service that is being documented
|
|
|
|-
| facility
| token
| Kind of facility where patient was seen
|
|
|
|-
| event
| token
| Main clinical acts documented
|
|
|
|-
| securitylabel
| token
| Document security-tags
|
|
|
|-
| format
| token
| Format/content rules for the document
|
|
|
|-
| related-id
| token
| Identifier of related objects or events
|
|
|
|}

The PDF/A use cases within MedMij especially use of the search parameters '''indexed''' and '''status''' for DocumentReference and '''created''' and '''status''' for DocumentManifest.

====Response message====
The Document Responder shall process the query to discover the DocumentReference or DocumentManifest entries that match the search parameters given. The Document Responder returns an HTTP Status code appropriate to the processing as well as a Bundle including the matching DocumentReference or DocumentManifest Resources. When the Document Responder needs to report an error or warning, it shall use HTTP error response codes and should include a FHIR [http://hl7.org/fhir/STU3/operationoutcome.html OperationOutcome] with more details on the failure or warning. If the request message is processed successfully, whether or not any DocumentReference or DocumentManifest Resources are found, the HTTP status code shall be 200.

* The Document Responder shall place into the ''''DocumentReference.content.attachment.url'''' element a full URL that can be used by the Document Consumer to retrieve the document using Retrieve Document transaction.
* The Document Responder shall return only PDF/A documents and shall place into the ''''DocumentReference.content.attachment.contentType'''' element the value 'application/pdf'.

'''Example of a response message'''

Example of a Bundle with 11 DocumentReference Resources. Only the first DocumentReference is displayed.

<pre>
<Bundle xmlns="http://hl7.org/fhir">
<id value="c0beb362-efc7-4cb9-b35a-c6cea0742156" />
<meta>
<versionId value="1498fcb4-af9c-404f-b445-e6634619df55" />
<lastUpdated value="2017-10-25T11:25:00.336+00:00" />
</meta>
<type value="searchset" />
<total value="11" />
<link>
<relation value="self" />
<url value="http://vonk.furore.com/DocumentReference?status=current" />
</link>
<entry>
<fullUrl value="http://vonk.furore.com/DocumentReference/c4f22730-bb5a-4f12-b4ef-c7bde0784426" />
<resource>
<DocumentReference xmlns="http://hl7.org/fhir">
<id value="example-pdfa-documentreference2" />
<meta>
<profile value="http://ihe.net/fhir/StructureDefinition/IHE.MHD.Query.Minimal.DocumentReference"/>
</meta>
<contained>
<Practitioner>
<id value="p1"/>
<name>
<family value="Kneder"/>
<given value="B.">
<extension url="http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier">
<valueCode value="IN"/>
</extension>
</given>
</name>
</Practitioner>
</contained>
<masterIdentifier>
<system value="urn:ietf:rfc:3986" />
<value value="urn:oid:1.2.276.0.7230010.3.1.2.1787205428.3024.1522314975.220899" />
</masterIdentifier>
<identifier>
<system value="http://example-xis.org/fhir/NamingSystem/DocumentReferenceID"/>
<value value="963369"/>
</identifier>
<status value="current" />
<type>
<coding>
<system value="http://loinc.org/" />
<code value="34781-5" />
<display value="Infectious disease Consult note" />
</coding>
</type>
<class>
<coding>
<system value="http://loinc.org/" />
<code value="11488-4" />
<display value="Consult Note" />
</coding>
</class>
<subject>
<reference value="Patient/example-pdfa-kwalificatie1" />
</subject>
<indexed value="2017-04-08T15:26:01+01:00" />
<author>
<reference value="#p1" />
</author>
<description value="Infectious disease Consult note" />
<securityLabel>
<coding>
<system value="http://hl7.org/fhir/v3/Confidentiality" />
<code value="V" />
<display value="very restricted" />
</coding>
</securityLabel>
<content>
<attachment>
<contentType value="application/pdf" />
<language value="en" />
<url value="http://example-test-server.org/fhir/Binary/example-pdfa-binary2" />
<title value="Example PDF - Infectious disease Consult note"/>
</attachment>
</content>
</DocumentReference>
</resource>
<search>
<mode value="match" />
</search>
</entry>
.......
</pre>

===Retrieve PDF/A document===
After obtaining the location of the PDF/A document in the DocumentReference.content.attachment.url, the Document Consumer requests the document from the Document Responder. The Document Responder sequentially serves the PDF/A document to the Document Consumer. The context that was established in the initial request shall also apply when retrieving/serving the document contents.

====Request Message====
This message is an HTTP GET request to retrieve the document. See an example below.

<pre>GET http://example:9556/svc/fhir/Binary/1e404af3-077f-4bee-b7a6-a9be97e1ce32</pre>

The Document Consumer may provide an HTTP Accept header, according to the semantics of the HTTP protocols (see RFC2616, Section 14.1). The only MIME type assured to be returned is the
MIME type indicated in the 'DocumentReference.content.attachment.contentType'. Within MedMij this is set to 'application/pdf'. The HTTP If-Unmodified-Since header shall not be included in the GET request

====Response Message====
The Document Responder shall process the request message. The Document Responder returns an HTTP Status code appropriate to the processing as well as the content of the requested PDF/A document in the HTTP message-body.

The document may be placed inside a FHIR [http://hl7.org/fhir/STU3/binary.html Binary] resource if it is useful to handle pure binary content using the same framework as other resources. Binary resources behave slightly differently from all other resources on the RESTful API. Specifically, when a read request is made for the binary resource that doesn't explicitly specify the FHIR content types "application/fhir+xml" or "application/fhir+json", then the content should be returned using the content type stated in the resource. e.g. if the content type in the resource is "application/pdf", then the content should be returned as a PDF directly.[http://hl7.org/fhir/STU3/binary.html#rest]

When the Document Responder needs to report an error or warning, it shall use HTTP error response codes and should include a [http://hl7.org/fhir/STU3/operationoutcome.html OperationOutcome] with more details on the failure or warning. If the Retrieve Document message is processed successfully the HTTP status code shall be 200.

'''Example of a response message'''
<pre><Binary>
<id value="1e404af3-077f-4bee-b7a6-a9be97e1ce32" />
<meta>
<versionId value="948f3653-c9a3-4831-bae5-f629319c194f" />
<lastUpdated value="2017-09-20T17:55:14.098+00:00" />
</meta>
<contentType value="application/pdf" />
<content value="JVBERi0xLjUNJeLjz9MNCjU1I........"/>
</Binary></pre>

==Interactions, operations, search parameters==

===Interactions===
The following logical interactions are needed for this use case:
* [http://hl7.org/fhir/STU3/http.html#search Search]
* [http://hl7.org/fhir/STU3/http.html#read Read]

===Operations===
There are no defined operations for this use case.

===Search parameters===
The following search parameter types need to be supported for this use case. No search result parameters need to be supported.

Search parameter types:
* [http://hl7.org/fhir/STU3/search.html#token token]
* [http://hl7.org/fhir/STU3/search.html#reference reference]
* [http://hl7.org/fhir/STU3/search.html#date date]
* [http://hl7.org/fhir/STU3/search.html#uri uri]

==List of StructureDefinitions==
IHE has defined StructureDefinitions and other Conformance resources applicable to this use case. The FHIR Implementation Guide on the '''[http://wiki.ihe.net/index.php/Mobile_access_to_Health_Documents_(MHD)#FHIR_Implementation_Guide IHE MHD wiki]''' lists these StructureDefinitions.

Find and retrieve existing PDF/A document transaction uses the following StructureDefinitions (links are not resolvable!):

* DocumentReference from Query with Minimal Metadata (canonical URL http://ihe.net/fhir/StructureDefinition/IHE.MHD.Query.Minimal.DocumentReference)
* DocumentManifest (canonical URL http://ihe.net/fhir/StructureDefinition/IHE.MHD.DocumentManifest)

* Optionally: DocumentReference from Query with Comprehensive Metadata (canonical URL: http://ihe.net/fhir/StructureDefinition/IHE.MHD.Query.Comprenensive.DocumentReference). This StructureDefinition has more mandatory field compared to Minimal Metadata and is used for XDS environments.

{{IssueBox|The IHE StructureDefinitions restrict the use of the .created element. This is a known issue and will be addressed in the R4 release of the profiles. This issue (CP-ITI-1100) can be found on the [http://wiki.ihe.net/index.php/Mobile_access_to_Health_Documents_(MHD)#FHIR_Implementation_Guide IHE MHD wiki]. Therefore the indexed element is used to capture creation time.}}

MedMij:V2018.04 FHIR LaboratoryResults

2018-08-30T12:57:19Z

Marten Smits:

{{#customtitle:MedMij FHIR use case LaboratoryResults}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:LabResults@2x.png|87px|links|Use case Medication|Medication process]]
<imagemap>Bestand:Leeswijzer-technisch-banner 03 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.04_OntwerpLabresult|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.04_FHIR_IG|Technisch]]
desc none
</imagemap>

=Introduction=
[[Bestand:Functioneel-02.png|link=MedMij:V2018.04_Ontwerpen |100px|rechts|Functional design|Go to functional design]]

This page describes patient's use cases for the retrieval of laboratory results, in a personal health environment (PHR) context. Functional specifications are described at the [[MedMij:V2018.04_Ontwerpen| functional design wiki page]]. The technical specification is described here. HL7 FHIR STU3 is used for this purpose.

Many laboratory result observations have important relationships to other observations and need to be grouped together. [http://hl7.org/fhir/observation.html#10.1.4.1 The FHIR specification] defines three structures to do this: DiagnosticReport and DiagnosticReport.result, Observation and Observation.component, and Observation and Observation.related. For the transactions of laboratory results retrieval, the following two grouping structures are relevant.

====Observation====
Individual laboratory results are represented by Observation resources, such as one blood glucose value. The Observation resource can also be used as a structure for a panel or battery observation. Observation.related is used for any supporting result that can be interpreted and used on its own and has one or more different values for method, observation, performer, device, time, and/or error conditions. The top-level observation specifies the grouping code in Observation.code, but typically does not have its own Observation.value, and the set of member observations are listed in the Observation.related element.

====DiagnosticReport====
In contrast to the Observation resource, the DiagnosticReport resource typically includes additional clinical context and some mix of atomic results, images, imaging reports, textual and coded interpretation, and formatted representations. Report conclusions can be expressed as a simple text blob, structured coded data or as an attached fully formatted report such as a PDF. The DiagnosticReport.code names the panel and serves as the grouping element, which is traditionally referred to as a "panel" or "battery" by laboratories. The DiagnosticReport.result element references the individual observations.

Both structures may exist in a XIS. Therefore, two transactions are defined to retrieve a patient's laboratory results. The transaction content either consists of a single and related laboratory results structure or a complete diagnostic report that adds more clinical meaning to the single and related laboratory results. The transactions:

* [[MedMij:V2018.04_FHIR_LaboratoryResults#Use_case:_retrieve_laboratory_results| Retrieve laboratory results]]
* [[MedMij:V2018.04_FHIR_LaboratoryResults#Use_case:_retrieve_laboratory_results_DiagnosticReport| Retrieve laboratory results DiagnosticReport]]

=Actors involved=
{| class="wikitable"
! colspan="2" style="text-align:left;" | Persons
! colspan="2" style="text-align:left;" | Systems
! colspan="2" style="text-align:left;" | FHIR Capability Statements
|-
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
|-
| Patient
| The user of a personal healthcare enviorment.
| PHR
| Personal health record
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/NictizSTU3/labresults-clientcapabilities CapabilityStatement: Client]
| LaboratoryResults process client requirements
|-
| Healthcare professional
| The user of a XIS
| XIS
| Healthcare information system
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/NictizSTU3/labresults-servercapabilities CapabilityStatement: Server]
| LaboratoryResults server requirements
|}

=Use case: retrieve laboratory results=
{{FHIR-IG-Afsprakenstelsel-Note}}

==Introduction==
The retrieve laboratory results transaction is used by the PHR to retrieve laboratory results from a XIS.

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transaction group'''
! style="text-align:left;"| '''Transaction'''
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;" rowspan="3"|Retrieve Laboratory Results(PULL)
|style="background-color: white;vertical-align:top;"|Retrieve laboratory results request
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Request laboratory results from the XIS
|-
|style="background-color: white;vertical-align:top;"|Retrieve laboratory results response
|style="background-color: white;vertical-align:top;"|Healthcare professional (using a XIS)
|style="background-color: white;vertical-align:top;"|Serves laboratory results to the PHR
|}

==Invocations==
===PHR: request message===
The request message represents an HTTP GET parameterized query from the PHR to the XIS.

====Trigger Events====
When the patient(PHR) wants to obtain laboratory results, it issues a retrieve laboratory results request message.

====Message Semantics====
The PHR executes an HTTP GET conform to the FHIR [http://hl7.org/fhir/http.html RESTfull] and [http://hl7.org/fhir/search.html search] specification against the XIS's Observation endpoint. This search query URL is configurable by the PHR and has the following format.

<pre>
GET [base]/Observation?[parameters]{&_format=[mime-type]}
</pre>

=====Search Parameters=====
The PHR may supply, and the XIS shall be capable of processing, all query parameters listed below. These search parameters are a selection of the defined search parameters by the HL7 FHIR specification search parameters of [http://hl7.org/fhir/STU3/observation.html#search Observation].

{| class="wikitable"
! colspan="3" style="font-weight: bold; text-align:left;" | Observation
|-
| style="font-weight: bold;" | Name
| style="font-weight: bold;" | Type
| style="font-weight: bold;" | Description
|-
| date
| date
| Obtained date/time. If the obtained element is a period, a date that falls in the period.
|-
|category
|token
|The classification of the type of observation.
|}

=====Search on fixed category code=====
To distinguish the ZIB LaboratoryTestResults Observations from other Observation resources, such as ZIB DrugUse observations, a fixed category code has been added to the ZIB LaboratoryTestResults profile. This fixed category code is solely used for indexing and retrieval of the ZIB building blocks. For LaboratoryTestResult Observations this category code is SNOMED code '49581000146104' - Laboratory test finding (finding).

=====Including other resources in search results=====
The PHR may request that the XIS return resources related to the search results, in order to reduce the overall network delay of repeated retrievals of related resources. This is useful when the PHR is searching on a clinical resource, but for every such resource returned, the client will also need for example the subject (Patient resource) or performer (Organization / Practitioner resource) or Specimen resource that the clinical resource refers to. The client can use the _include parameter to indicate that the subject resources be included in the results. An example is shown below.

=====Example search URLs=====

<pre>
1. GET https://vonk.test-nictiz.nl/Observation?category=http://snomed.info/sct|49581000146104
2. GET https://vonk.test-nictiz.nl/Observation?category=http://snomed.info/sct|49581000146104&date=ge2010-01-01
3. GET https://vonk.test-nictiz.nl/Observation?category=http://snomed.info/sct|49581000146104&date=ge2010-01-01&date=le2011-12-31
4. GET https://vonk.test-nictiz.nl/Observation?include=Observation:specimen&category=http://snomed.info/sct|49581000146104date=ge2010-01-01&date=le2011-12-31</pre>

# Retrieves all ZIB LaboratoryTestResults Observation resources
# Retrieves all ZIB LaboratoryTestResults Observation resources that have an effective date greater than 01-01-2010.
# Retrieves all ZIB LaboratoryTestResults Observation resources that have an effective date within a 2 year period.
# Retrieves all ZIB LaboratoryTestResults Observation resources that have an effective date within a 2 year period and includes Specimen information in the search results.

=====Expected Actions=====
The XIS shall process the query to discover Observation resources that match the search parameters given.

===XIS: response message===
The XIS returns an HTTP Status code appropriate to the processing as well as a FHIR Bundle including the matching observation information.

====Trigger Events====
The XIS completed processing of the retrieve laboratory results request message.

====Message Semantics====
Based on the query results, the XIS will either return an error or success. When the XIS needs to report an error, it SHALL use HTTP error response codes and SHOULD include a FHIR OperationOutcome resource with more details on the failure. If the request message is processed successfully, whether or not any observation resources are found, the HTTP status code SHALL be 200.

The response message shall be a Bundle resource of type "searchset" containing zero or more FHIR resources as entries. If the XIS is sending warnings, the Bundle resource SHALL also contain a FHIR OperationOutcome resource that contains those warnings. The FHIR specification describes the relevant sections:
*[http://hl7.org/fhir/STU3/http.html RESTful API framework]
*[http://hl7.org/fhir/STU3/search.html#errors Search errors]
*[http://hl7.org/fhir/STU3/bundle.html Bundle resource]
*[http://hl7.org/fhir/operationoutcome.html OperationOutcome resource]

=====Message resource content=====
The returned data to the PHR should conform to the profiles listed in the table below. This table shows the relevant ZIBs and their related profiles. The resources in the response message SHALL be a valid instance of these profiles. All resources SHALL include their related profile canonical URL in the ''meta.profile'' element in order to show compliance.

{| class="wikitable" width="1400px"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|ZIB name NL||ZIB name EN||FHIR Resource||URL profile|
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Patient
| #ZIB Patient|Patient
| Patient
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
|-
| Zorgverlener
| HealthProfessional
| Practitioner
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
|-
| Zorgaanbieder
| HealthcareProvider
| Organization
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
|-
| rowspan="2" | LaboratoriumUitslag
| rowspan="2" | LaboratoryTestResult
| Observation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-LaboratoryTestResult-Observation http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Observation]
|-
| Specimen
| [https://simplifier.net/NictizSTU3-Zib2017/zib-LaboratoryTestResult-Specimen http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Specimen]
|}

====Expected Actions====
The PHR shall process the results according to application-defined rules. The PHR should be robust as the response may contain observation and specimen resources that match the query parameters.

==Interactions, operations, search parameters==
===Interactions===
The following logical interactions are needed for the retrieve laboratory results transaction:
* [http://hl7.org/fhir/STU3/http.html#search Search]

===Operations===
No operations are defined or needed for this transaction.

===Search parameters===
The following search parameter type needs to be supported for this transaction.

Search parameter types:
* [http://hl7.org/fhir/STU3/search.html#token token]
* [http://hl7.org/fhir/STU3/search.html#date date]

Search result parameters:
* [http://hl7.org/fhir/STU3/search.html#include _include]

==Examples==

=Use case: retrieve laboratory results DiagnosticReport=
{{FHIR-IG-Afsprakenstelsel-Note}}

==Introduction==
The retrieve laboratory diagnostic report transaction is used by the PHR to retrieve laboratory results from a XIS.

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transaction group'''
! style="text-align:left;"| '''Transaction'''
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;" rowspan="3"|Retrieve Laboratory Results(PULL)
|style="background-color: white;vertical-align:top;"|Retrieve laboratory diagnostic report request
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Request laboratory diagnostic report from the XIS
|-
|style="background-color: white;vertical-align:top;"|Retrieve laboratory diagnostic report response
|style="background-color: white;vertical-align:top;"|Healthcare professional (using a XIS)
|style="background-color: white;vertical-align:top;"|Serves laboratory diagnostic report to the PHR
|}

==Invocations==
===PHR: request message===
The request message represents an HTTP GET parameterized query from the PHR to the XIS.

====Trigger Events====
When the patient(PHR) wants to obtain laboratory diagnostic report, it issues a retrieve laboratory diagnostic report request message.

====Message Semantics====
The PHR executes an HTTP GET conform to the FHIR [http://hl7.org/fhir/http.html RESTfull] and [http://hl7.org/fhir/search.html search] specification against the XIS's DiagnosticReport endpoint. This search query URL is configurable by the PHR and has the following format.

<pre>
GET [base]/DiagnosticReport?[parameters]{&_format=[mime-type]}
</pre>

=====Search Parameters=====
The PHR may supply, and the XIS shall be capable of processing, all query parameters listed below. These search parameters are a selection of the defined search parameters by the HL7 FHIR specification search parameters of [http://hl7.org/fhir/STU3/diagnosticreport.html#search DiagnosticReport].

{| class="wikitable"
! colspan="3" style="font-weight: bold; text-align:left;" | DiagnosticReport
|-
| style="font-weight: bold;" | Name
| style="font-weight: bold;" | Type
| style="font-weight: bold;" | Description
|-
| date
| date
| The clinically relevant time of the report.
|-
| category
| token
| Which diagnostic discipline/department created the report.
|}

=====Search on ZIB LaboratoryTestResult DiagnosticReport=====
A fixed category code has been added to the ZIB LaboratoryTestResults profile to distinguish the ZIB LaboratoryTestResult DiagnosticReports between other DiagnosticReport resources. This fixed category code is solely used for indexing and retrieval of the ZIB building blocks. For LaboratoryTestResult DiagnosticReport this category is SNOMED code '4241000179101' - Laboratory report (record artifact).

=====Including other resources in searchresults=====
The PHR may request that the XIS return resources related to the search results, in order to reduce the overall network delay of repeated retrievals of related resources. This is useful when the PHR is searching on a clinical resource, but for every such resource returned, the client will also need for example the subject (Patient resource) or performer (Organization / Practitioner resource) or the Observation resource that the clinical resource refers to. The client can use the _include parameter to indicate that the subject resources be included in the results. An example is shown below.

=====Example search URLs=====
<pre>
1. GET https://vonk.test-nictiz.nl/DiagnosticReport?category=http://snomed.info/sct|4241000179101
2. GET https://vonk.test-nictiz.nl/DiagnosticReport?category=http://snomed.info/sct|4241000179101&date=ge2010-01-01
3. GET https://vonk.test-nictiz.nl/DiagnosticReport?category=http://snomed.info/sct|4241000179101&date=ge2010-01-01&date=le2011-12-31
4. GET https://vonk.test-nictiz.nl/DiagnosticReport?category=http://snomed.info/sct|4241000179101&include=DiagnosticReport:result&date=ge2010-01-01&date=le2011-12-31 </pre>

# Retrieves all ZIB LaboratoryTestResult DiagnosticReport resources
# Retrieves all ZIB LaboratoryTestResult DiagnosticReport resources that have an effective date greater than 01-01-2010.
# Retrieves all ZIB LaboratoryTestResult DiagnosticReport resources that have an effective date within a 2 year period.
# Retrieves all ZIB LaboratoryTestResult DiagnosticReport resources that have an effective date within a 2 year period and include the referenced Observation resources in the search results.

=====Expected Actions=====
The XIS shall process the query to discover DiagnosticReport resources that match the search parameters given.

===XIS: response message===
The XIS returns an HTTP Status code appropriate to the processing as well as a FHIR Bundle including the matching laboratory diagnostic report information.

====Trigger Events====
The XIS completed processing of the retrieve laboratory diagnostic report request message.

====Message Semantics====
Based on the query results, the XIS will either return an error or success. When the XIS needs to report an error, it SHALL use HTTP error response codes and SHOULD include a FHIR OperationOutcome resource with more details on the failure. If the request message is processed successfully, whether or not any DiagnosticReport resources are found, the HTTP status code SHALL be 200.

The response message shall be a Bundle resource of type "searchset" containing zero or more FHIR resources as entries. If the XIS is sending warnings, the Bundle resource SHALL also contain a FHIR OperationOutcome resource that contains those warnings. The FHIR specification describes the relevant sections:
*[http://hl7.org/fhir/STU3/http.html RESTful API framework]
*[http://hl7.org/fhir/STU3/search.html#errors Search errors]
*[http://hl7.org/fhir/STU3/bundle.html Bundle resource]
*[http://hl7.org/fhir/operationoutcome.html OperationOutcome resource]

=====Message resource content=====
The returned data to the PHR should conform to the profiles listed in the table below. This table shows the relevant ZIBs and their related profiles. The resources in the response message SHALL be a valid instance of these profiles. All resources SHALL include their related profile canonical URL in the ''meta.profile'' element in order to show compliance.

{| class="wikitable" width="1400px"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|ZIB name NL||ZIB name EN||FHIR Resource||URL profile|
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Patient
| #ZIB Patient|Patient
| Patient
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
|-
| Zorgverlener
| HealthProfessional
| Practitioner
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
|-
| Zorgaanbieder
| HealthcareProvider
| Organization
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
|-
| rowspan="3" | LaboratoriumUitslag
| rowspan="3" | LaboratoryTestResult
| DiagnosticReport
| [https://simplifier.net/NictizSTU3-Zib2017/zib-LaboratoryTestResult-DiagnosticReport http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-DiagnosticReport]
|-
| Observation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-LaboratoryTestResult-Observation http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Observation]
|-
| Specimen
| [https://simplifier.net/NictizSTU3-Zib2017/zib-LaboratoryTestResult-Specimen http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Specimen]
|}

====Expected Actions====
The PHR shall process the results according to application-defined rules. The PHR should be robust as the response may contain DiagnosticReport, Observation and Specimen resources that match the query parameters.

==Interactions, operations, search parameters==
===Interactions===
The following logical interactions are needed for the retrieve laboratory results transaction:
* [http://hl7.org/fhir/STU3/http.html#search Search]

===Operations===
No operations are defined or needed for this transaction.

===Search parameters===
The following search parameter type needs to be supported for this transaction.

Search parameter types:
* [http://hl7.org/fhir/STU3/search.html#token token]
* [http://hl7.org/fhir/STU3/search.html#date date]

Search result parameters:
* [http://hl7.org/fhir/STU3/search.html#include _include]

==Examples==
[[categorie:MedMij FHIR Use Cases]]

MedMij:V2018.04 FHIR VitalSigns

2018-08-30T12:57:00Z

Marten Smits:

{{#customtitle:MedMij FHIR use case Vital Signs}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:Self-measurements_Icoon.png|link=MedMij_VitalSigns|87px |links||Self-Measurements]]
<imagemap>Bestand:Leeswijzer-technisch-banner 03 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.04_OntwerpZelfmetingen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.04_FHIR_IG|Technisch]]
desc none
</imagemap>

__TOC__

=Introduction=
[[Bestand:Functioneel-02.png|link=MedMij:V2018.04_Ontwerpen |100px|rechts|Functional design|Go to functional design]]

This use case is mainly based on the HL7 FHIR vital signs specification - http://hl7.org/fhir/STU3/observation-vitalsigns.html. The HL7 FHIR vital signs specification is extended with profiles of ZIB concepts that represent vital signs. These profiles are derived from the official [http://hl7.org/fhir/observation-vitalsigns.html HL7 Vital Signs profiles]. The purpose of these profiles is to add additional concepts that are not in the vital sign profiles but are provided in the corresponding ZIB. Moreover, these derived profiles include ZIB to FHIR mappings.

'''Technical note:'''

Because the base [http://hl7.org/fhir/vitalsigns.html vital signs] profile constrains the <code>.code</code> and the <code>.component.code</code> to the datatype quantity it is not possible to add additional ZIB concepts. A GForge [https://gforge.hl7.org/gf/project/fhir/tracker/?action=TrackerItemEdit&tracker_item_id=13796 issue] is created to address this problem. This issue will most likely be resolved with FHIR version STU4. However, to address this problem now the base vital signs panel is copied, the datatype constrains removed and published under a different canonical URL. The HL7 vital sign profiles bloodpressure, bodyweight, and oxygensaturation are copied, the StructureDefinition.baseDefinition adjusted and published under a different canonical URL because they are in the chain of derived profiles and the component.code needs to be used for these vital signs.

Use cases:
* [[MedMij:V2018.04_FHIR_VitalSigns#Use_case:_Retrieve_Vital_Signs|Retrieve vital signs]]
* [[MedMij:V2018.04_FHIR_VitalSigns#Use_case:_Send_Vital_Signs|Send vital signs]]

=Actors involved=
{| class="wikitable"
! colspan="2" style="text-align:left;" | Persons
! colspan="2" style="text-align:left;" | Systems
! colspan="2" style="text-align:left;" | FHIR Capability Statements
|-
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
|-
| Patient
| The user of a personal healthcare environment.
| PHR
| Personal health record
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/NictizSTU3/vitalsigns-clientcapabilities CapabilityStatement: Client]
| Vital Signs client requirements
|-
| Healthcare professional
| The user of a XIS
| XIS
| Healthcare information system
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/NictizSTU3/vitalsigns-servercapabilities CapabilityStatement: Server]
| Vital Signs server requirements
|}

=Use case: Retrieve Vital Signs=
{{FHIR-IG-Afsprakenstelsel-Note}}

==Introduction==
The retrieve vital signs transaction is used by the PHR to retrieve vital signs from the XIS.

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transaction group'''
! style="text-align:left;"| '''Transaction'''
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Retrieve Vital Signs(PULL)
|style="background-color: white;vertical-align:top;"|Retrieve vital signs request
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Request vital signs from the XIS
|-
|style="background-color: white;vertical-align:top;"|Retrieve vital signs response
|style="background-color: white;vertical-align:top;"|Healthcare professional (using a XIS)
|style="background-color: white;vertical-align:top;"|Serves vital signs to the PHR
|}

==Invocations==
===PHR: request message===
The request message represents an HTTP GET parameterized query from the PHR to the XIS.

====Trigger Events====
When the patient(PHR) wants to obtain vital signs, it issues a retrieve vital signs request message.

====Message Semantics====
'''Search'''

The PHR executes an HTTP GET conform to the FHIR [http://hl7.org/fhir/http.html RESTfull] and [http://hl7.org/fhir/search.html search] specification against the XIS's Observation endpoint. This search query URL is configurable by the PHR and has the following format.

<pre>
GET [base]/Observation?[parameters]{&_format=[mime-type]}
</pre>

'''Search Parameters'''

The PHR may supply, and the XIS shall be capable of processing, all query parameters listed below. These search parameters are a selection of the defined search parameters by the HL7 FHIR specification search parameters of [http://hl7.org/fhir/STU3/observation.html#search Observation].

{| class="wikitable"
! colspan="3" style="font-weight: bold; text-align:left;" | Observation
|-
| style="font-weight: bold;" | Name
| style="font-weight: bold;" | Type
| style="font-weight: bold;" | Description
|-
| category
| token
| The classification of the type of observation
|-
| code
| token
| The code of the observation type
|-
| date
| date
| Obtained date/time. If the obtained element is a period, a date that falls in the period
|}

'''Example searches'''

The PHR should be able to fetch all of a patient's vital signs by searching on:
# category (all vital signs),
# category and date,
# code (specific vital sign),
# code and date.
<pre>1. GET [base]/Observation?category=vital-signs
2. GET [base]/Observation?category=vital-signs&date=[date]{&date=[date]}
3. GET [base]/Observation?code[vital sign LOINC{,LOINC2,LOINC3,...}]
4. GET [base]/Observation?code=[vital sign LOINC{,LOINC2,LOINC3,...}]&date=[date]{&date=[date]}
</pre>
The following table lists vital signs that have a corresponding ZIB. The column 'LOINC code' shows the LOINC code that can be used in the search query. Other possible codes, including the codes mentioned here, can be found [http://hl7.org/fhir/STU3/observation-vitalsigns.html#vitals-table here].

{| class="wikitable"
|-style="font-weight: bold; "
||ZIB ||LOINC code
|-
|BloodPressure||85354-9
|-
| BodyWeight||29463-7
|-
| BodyHeight||8302-2
|-
| BodyTemperature||8310-5
|-
| Oxygenation, saturation, SpO2||59408-5
|-
| HeartRate||8867-4
|-
| Glucose|| 41604-0 (fasting) 14743-9 (general) 14760-3 (post-meal)
|}
=====Expected Actions=====
The XIS shall process the query to find and return the vital signs matching the provided query parameters.

===XIS: response message===
The XIS returns an HTTP Status code appropriate to the processing as well as a Bundle of matching vital signs Observation.

====Trigger Events====
The XIS completed processing of the retrieve vital signs request message.

====Message Semantics====
Based on the retrieve vital signs request message processing results, the XIS will either return an error or success. When the XIS needs to report an error, it shall use HTTP error response codes and shall include a FHIR OperationOutcome resource with more details on the failure. If the request message is processed successfully, whether or not vital signs are found or generated, the HTTP status code shall be 200.

''Response Class:''
* Status 200: successful operation
* Status 400: invalid parameter
* Status 401/4xx: unauthorized request
* Status 403: insufficient scope

If the XIS is sending warnings, the Bundle resource shall also contain a FHIR OperationOutcome resource that contains those warnings. The FHIR specification describes the relevant sections:
*[http://hl7.org/fhir/STU3/observation-vitalsigns.html Vital Signs Profile]
*[http://hl7.org/fhir/STU3/http.html RESTful API framework]
*[http://hl7.org/fhir/STU3/search.html Search]
*[http://hl7.org/fhir/STU3/bundle.html Bundle resource]
*[http://hl7.org/fhir/STU3/operationoutcome.html OperationOutcome resource]

=====Message Resource content=====
The body of the response message shall be a Bundle of type 'searchset' containing all matching vital sign Observations as entries. If no Observations are found, a Bundle of type 'searchset' shall be returned without any Observation as entries.

In the table below, the vital sign ZIB's and their respective profiles are listed. Other vital signs profiles, without a corresponding ZIB, are can be found in the [http://hl7.org/fhir/STU3/observation-vitalsigns.html HL7 FHIR specification.]

All returned resources to the PHR SHALL include their related profile canonical URL in the meta.profile element in order to show compliance. The Observation resources in the response message SHALL be a valid instance of these profiles.

{| class="wikitable"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|style="width:150px;"|ZIB name NL||style="width:150px;"|ZIB name EN||style="width:150px;"|FHIR Resource||style="width:450px;"|FHIR profile
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Bloeddruk||BloodPressure||Observation||[https://simplifier.net/NictizSTU3-Zib2017/zib-BloodPressure http://nictiz.nl/fhir/StructureDefinition/zib-BloodPressure]
|-
| LichaamsGewicht||BodyWeight||Observation||[https://simplifier.net/NictizSTU3-Zib2017/zib-BodyWeight http://nictiz.nl/fhir/StructureDefinition/zib-BodyWeight]
|-
| LichaamsLengte||BodyHeight||Observation||[https://simplifier.net/NictizSTU3-Zib2017/zib-BodyHeight http://nictiz.nl/fhir/StructureDefinition/zib-BodyHeight]
|-
| Lichaamstemperatuur||BodyTemperature||Observation||[https://simplifier.net/NictizSTU3-Zib2017/zib-BodyTemperature http://nictiz.nl/fhir/StructureDefinition/zib-BodyTemperature]
|-
| O2Saturatie||oxygenation, saturation, SpO2||Observation||[https://simplifier.net/NictizSTU3-Zib2017/zib-OxygenSaturation http://nictiz.nl/fhir/StructureDefinition/zib-OxygenSaturation]
|-
| Hartfrequentie||HeartRate||Observation||[https://simplifier.net/NictizSTU3-Zib2017/zib-HeartRate http://nictiz.nl/fhir/StructureDefinition/zib-HeartRate]
|-
| Polsfrequentie||PulseRate||Observation||[https://simplifier.net/nictizstu3-zib2017/zib-pulserate http://nictiz.nl/fhir/StructureDefinition/zib-PulseRate]
|-
| -||-||Observation||[https://simplifier.net/NictizSTU3/BloodGlucose/~overview http://nictiz.nl/fhir/StructureDefinition/bloodGlucoseSelfMeasurement]
|}

====Expected Actions====
The PHR processes the results according to application-defined rules.

==Interactions, operations, search parameters==
===Interactions===
The following logical interactions are needed for the retrieve medication information transaction:
* [http://hl7.org/fhir/STU3/http.html#search Search]

===Operations===
No operations are defined or needed for this transaction.

===Search parameters===
The following search parameter types and search result parameters need to be supported for this transaction.

Search parameter types:
* [http://hl7.org/fhir/STU3/search.html#token token]
* [http://hl7.org/fhir/STU3/search.html#date date]

=Use case: Send Vital Signs=
{{IssueBox|Currently, PUSH is not supported by 'the Afsprakenstelsel'. The below guidance is subject to change.}}
==Introduction==
The send vital signs transaction is used by the PHR to send vital signs to the XIS.

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transaction group'''
! style="text-align:left;"| '''Transaction'''
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Send Vital Signs(PUSH)
|style="background-color: white;vertical-align:top;"|Send vital signs request
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Sends vital signs to the XIS
|-
|style="background-color: white;vertical-align:top;"|Send vital signs response
|style="background-color: white;vertical-align:top;"|Healthcare professional (using a XIS)
|style="background-color: white;vertical-align:top;"|Receives vital signs from the PHR
|}

==Invocations==
===PHR: request message===
The send vital sings request message uses the HTTP POST method on the target XIS's base.

====Trigger Events====
This message is invoked when the PHR needs to send one or more vital signs observations to the XIS.

====Message Semantics====
Because sending vital signs will most likely consist of multiple Observations, a batch/transaction transaction is used. This allows for creating a set of resources in a single interaction.

A batch interaction is performed by an HTTP POST command as shown:

<pre>POST [base] {?_format=[mime-type]}</pre>

The body of the post submission is a Bundle with Bundle.type = batch. Each entry carries request details (Bundle.entry.request) that provides the HTTP details of the action in order to inform the system processing the batch or what to do for the entry (note: the request is optional, but SHOULD be present). Every bundle.entry creates a resource using an HTTP POST method. The resource of this entry shall be the vital sign observation.

'''Links:'''

* [http://hl7.org/fhir/STU3/http.html#transaction batch]
* [http://hl7.org/fhir/STU3/http.html#create create]

The vital signs data send to the XIS SHALL conform to the matching vital sign profile. The table below lists profiles that represent ZIBs that can be used for vital sign information exchange. If no matching vital sign ZIB profile is present, vital sign profiles listed in the [http://hl7.org/fhir/STU3/observation-vitalsigns.html FHIR specification] can be used. Other vital sign concepts are currently out of scope for this use case.

The resources in the response message SHALL be a valid instance of these profiles. All resources SHALL include their related profile canonical URL in the meta.profile element in order to show compliance.

{| class="wikitable" width="1200px"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|style="width:150px;"|ZIB name NL||style="width:150px;"|ZIB name EN||style="width:150px;"|FHIR Resource||style="width:450px;"|FHIR Profile
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Bloeddruk||BloodPressure||Observation||[https://simplifier.net/NictizSTU3/zib-BloodPressure http://nictiz.nl/fhir/StructureDefinition/zib-BloodPressure]
|-
| LichaamsGewicht||BodyWeight||Observation||[https://simplifier.net/NictizSTU3/zib-BodyWeight http://nictiz.nl/fhir/StructureDefinition/zib-BodyWeight]
|-
| LichaamsLengte||BodyHeight||Observation||[https://simplifier.net/NictizSTU3/zib-BodyHeight http://nictiz.nl/fhir/StructureDefinition/zib-BodyHeight]
|-
| Lichaamstemperatuur||BodyTemperature||Observation||[https://simplifier.net/NictizSTU3/zib-BodyTemperature http://nictiz.nl/fhir/StructureDefinition/zib-BodyTemperature]
|-
| O2Saturatie||oxygenation, saturation, SpO2||Observation||[https://simplifier.net/NictizSTU3/zib-OxygenSaturation http://nictiz.nl/fhir/StructureDefinition/zib-OxygenSaturation]
|-
| Hartfrequentie||HeartRate||Observation||[https://simplifier.net/NictizSTU3/zib-HeartRate http://nictiz.nl/fhir/StructureDefinition/zib-HeartRate]
|-
| Glucose||Glucose||Observation||[https://simplifier.net/NictizSTU3/BloodGlucose/~overview http://nictiz.nl/fhir/StructureDefinition/bloodGlucoseSelfMeasurement]
|-
|}

=====Expected Actions=====
On receipt of the submission, the XIS shall validate the resources and respond with an appropriate HTTP code. If the XIS encounters any errors or if validation fails, the XIS shall return an error as documented in the Message Semantics of the response message.

===XIS: response message===
The XIS returns an HTTP Status code appropriate to the processing outcome and returns a Bundle, of type batch-response, that contains one entry for each entry in the request, in the same order, with the outcome of processing the entry.

====Trigger Events====
The XIS completed processing of the send vital signs request message.

====Message Semantics====
The XIS SHALL return a Bundle with type set to batch-response that contains one entry for each entry in the request, in the same order, with the outcome of processing the entry.

A client may use the returned Bundle to track the outcomes of processing the entry, and the identities assigned to the resources by the server. Each entry element SHALL contain a response element which details the outcome of processing the entry - the HTTP status code, and the location and ETag header values, which are used for identifying and versioning the resources. In addition, a resource may be included in the entry, as specified by the Prefer header.

When the resource syntax or data is incorrect or invalid, and cannot be used to create a new resource, the server returns a 400 Bad Request HTTP status code. When the server rejects the content of the resource because of business rules, the server returns a 422 Unprocessable Entity error HTTP status code. In either case, the server SHOULD include a response body containing an OperationOutcome with detailed error messages describing the reason for the error.

Common HTTP Status codes returned on FHIR-related errors (in addition to normal HTTP errors related to security, header and content type negotiation issues):

* 400 Bad Request - resource could not be parsed or failed basic FHIR validation rules
* 404 Not Found - resource type not supported, or not a FHIR end-point
* 422 Unprocessable Entity - the proposed resource violated applicable FHIR profiles or server business rules. This should be accompanied by an OperationOutcome resource providing additional detail

Read more:
[http://hl7.org/fhir/STU3/http.html#create create]
[http://hl7.org/fhir/STU3/http.html#transaction batch]

====Expected Actions====
The PHR processes the results according to application-defined rules.

==Interactions, operations, search parameters==
===Interactions===
The following logical interactions are needed for the retrieve medication information transaction:
* [http://hl7.org/fhir/STU3/http.html#create create]
* [http://hl7.org/fhir/STU3/http.html#transaction batch/transaction]

===Operations===
No operations are defined or needed for this transaction.

===Search parameters===
No search parameters are defined or needed for this transaction.

[[categorie:MedMij FHIR Use Cases]]

MedMij:V2018.04 FHIR AllergyIntolerance

2018-08-30T12:56:35Z

Marten Smits:

{{#customtitle:MedMij FHIR use case AllergyIntolerance}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:Allergie.png|link=|87px |links||AllergyIntolerance]]
<imagemap>Bestand:Leeswijzer-technisch-banner 03 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.04_OntwerpAllergieIntolerantie|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.04_FHIR_IG|Technisch]]
desc none
</imagemap>

__TOC__

=Introduction=
[[Bestand:Functioneel-02.png|link=MedMij:V2018.04_Ontwerpen |100px|rechts|Functional design|Go to functional design]]

This page describes a patient's use case, in a personal health record (PHR) context, in relation to the information standard [https://informatiestandaarden.nictiz.nl/wiki/Landingspagina_Medicatieproces Medication Process] for allergy and intolerance information. This use case is based on version 6.12.X of this standard. Functional specification of this use case is described in the [[MedMij:V2018.04_Ontwerpen| functional design wiki page]]. The technical specification is described here. HL7 FHIR STU3 is used for this purpose.

=Actors involved=
{| class="wikitable"
! colspan="2" style="text-align:left;" | Persons
! colspan="2" style="text-align:left;" | Systems
! colspan="2" style="text-align:left;" | FHIR Capability Statements
|-
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
|-
| Patient
| The user of a personal healthcare enviorment.
| PHR
| Personal health record
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/NictizSTU3/allergyintolerance-clientcapabilities CapabilityStatement: Client]
| AllergyIntolerance client requirements
|-
| Healthcare professional
| The user of a XIS
| XIS
| Healthcare information system
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/NictizSTU3/allergyintolerance-servercapabilities CapabilityStatement: Server]
| AllergyIntolerance server requirements
|}

=Use case: Retrieve AllergyIntolerance information=
{{FHIR-IG-Afsprakenstelsel-Note}}

==Introduction==
The retrieve AllergyIntolerance transaction is used by the PHR to retrieve allergy and intolerance information from the XIS.

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transaction group'''
! style="text-align:left;"| '''Transaction'''
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;" rowspan="3"|Retrieve AllergyIntolerance(PULL)
|style="background-color: white;vertical-align:top;"|Retrieve AllergyIntolerance request
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Request allergy and intolerance information from the XIS
|-
|style="background-color: white;vertical-align:top;"|Retrieve AllergyIntolerance response
|style="background-color: white;vertical-align:top;"|Healthcare professional (using a XIS)
|style="background-color: white;vertical-align:top;"|Serves allergy and intolerance information to the PHR
|}

==Invocations==
===PHR: request message===
The request message represents an HTTP GET parameterized query from the PHR to the XIS.

====Trigger Events====
When the patient(PHR) wants to obtain allergy and intolerance information, it issues a retrieve AllergyIntolerance request message.

====Message Semantics====
The PHR executes an HTTP GET conform to the FHIR [http://hl7.org/fhir/http.html RESTfull] and [http://hl7.org/fhir/search.html search] specification against the XIS's AllergyIntolerance endpoint. This search query URL is configurable by the PHR and has the following format.

<pre>
GET [base]/AllergyIntolerance?[parameters]{&_format=[mime-type]}
</pre>

=====Search Parameters=====
The PHR may supply, and the XIS shall be capable of processing, all query parameters listed below. These search parameters are a selection of the defined search parameters by the HL7 FHIR specification search parameters of [http://hl7.org/fhir/STU3/allergyintolerance.html#search AllergyIntolerance].

{| class="wikitable"
! colspan="3" style="font-weight: bold; text-align:left;" | AllergyIntolerance
|-
| style="font-weight: bold;" | Name
| style="font-weight: bold;" | Type
| style="font-weight: bold;" | Description
|-
| onset
| date
| Date(/time) when manifestations showed
|}

=====Example search URLs=====

<pre>
1. GET https://vonk.test-nictiz.nl/AllergyIntolerance
2. GET https://vonk.test-nictiz.nl/AllergyIntolerance?onset=ge2010-01-01&onset=le2011-12-31 </pre>

# Retrieves all AllergyIntolerance resources.
# Retrieves all AllergyIntolerance resources that have an onset date(/time) within a 2 year period.

=====Expected Actions=====
The XIS shall process the query to discover AllergyIntolerance resources that match the search parameters given.

===XIS: response message===
The XIS returns an HTTP Status code appropriate to the processing as well as a FHIR Bundle including the allergy and intolerance medication information.

====Trigger Events====
The XIS completed processing of the Retrieve AllergyIntolerance request message.

====Message Semantics====
Based on the query results, the XIS will either return an error or success. When the XIS needs to report an error, it SHALL use HTTP error response codes and SHOULD include a FHIR OperationOutcome resource with more details on the failure. If the request message is processed successfully, whether or not any AllergyIntolerance resources are found, the HTTP status code SHALL be 200.

The response message shall be a Bundle resource of type "searchset" containing zero or more FHIR resources as entries. If the XIS is sending warnings, the Bundle resource SHALL also contain a FHIR OperationOutcome resource that contains those warnings. The FHIR specification describes the relevant sections:
*[http://hl7.org/fhir/STU3/http.html RESTful API framework]
*[http://hl7.org/fhir/STU3/search.html#errors Search errors]
*[http://hl7.org/fhir/STU3/bundle.html Bundle resource]
*[http://hl7.org/fhir/operationoutcome.html OperationOutcome resource]

=====Message resource content=====
The returned data to the PHR should conform to the ZIB AllergyIntolerance profile. The table below shows the relevant ZIBs and their profiles. The resources in the response message SHALL be a valid instance of these profiles. All resources SHALL include their related profile canonical URL in the ''meta.profile'' element in order to show compliance.

{| class="wikitable"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|ZIB name NL||ZIB name EN||FHIR Resource||URL profile||Reference to section
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Patient
| #ZIB Patient|Patient
| Patient
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_Patient | Patient]]
|-
| Zorgverlener
| HealthProfessional
| Practitioner
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_HealthProfessional | HealthProfessional]]
|-
| AllergieIntolerantie
| AllergyIntolerance
| AllergyIntolerance
| [https://simplifier.net/NictizSTU3-Zib2017/zib-AllergyIntolerance http://nictiz.nl/fhir/StructureDefinition/zib-AllergyIntolerance]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_AllergyIntolerance| AllergyIntolerance]]
|}

====Expected Actions====
The PHR processes the results according to application-defined rules. The PHR should be robust as the response may contain medication information resources as mentioned in the former section.

==Interactions, operations, search parameters==
===Interactions===
The following logical interactions are needed for the retrieve medication information transaction:
* [http://hl7.org/fhir/STU3/http.html#search Search]

===Operations===
No operations are defined or needed for this transaction.

===Search parameters===
The following search parameter types and search result parameters need to be supported for this transaction.

Search parameter types:
* [http://hl7.org/fhir/STU3/search.html#date date]

[[categorie:MedMij FHIR Use Cases]]

MedMij:V2018.04 FHIR MedicationProcess

2018-08-30T12:56:20Z

Marten Smits:

{{#customtitle:MedMij FHIR use case Medication Process}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:Medication_Icoon.png|link=|85px|links|Use case Medication|Medication process]]
<imagemap>Bestand:Leeswijzer-technisch-banner 03 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.04_OntwerpMedicatie|Functional]]
circle 1787 230 212 [[MedMij:V2018.04_FHIR_IG|Tecnical]]
desc none
</imagemap>

__TOC__

=Introduction=
[[Bestand:Functioneel-02.png|link=MedMij:V2018.04_Ontwerpen |100px|rechts|Functional design|Go to functional design]]

This page describes patient's use cases, in a personal health record (PHR) context, in relation to the information standard [https://informatiestandaarden.nictiz.nl/wiki/Landingspagina_Medicatieproces Medication Process] (MP). These use cases are based on version 9.x of this standard. Functional specification of these use cases are described in the [[MedMij:V2018.04_Ontwerpen| functional design wiki page]]. The technical specification is described here. HL7 FHIR STU3 is used for this purpose.

The Medication Process information building blocks are adopted by 'Registratie aan de Bron' and converted to Health and Care Information models, also called ZIB's. In order to exchange medication information between systems, FHIR representations of these ZIB's are made and used in the transactions described on this page.

Use cases:
* [[MedMij:V2018.04_FHIR_MedicationProcess#Use_case:_retrieve_medication_overview|Retrieve a medication overview]]
* [[MedMij:V2018.04_FHIR_MedicationProcess#Use_case:_retrieve_medication_information|Retrieve medication information]]

=Actors involved=
{| class="wikitable"
! colspan="2" style="text-align:left;" | Persons
! colspan="2" style="text-align:left;" | Systems
! colspan="2" style="text-align:left;" | FHIR Capability Statements
|-
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
|-
| Patient
| The user of a personal healthcare enviorment.
| PHR
| Personal health record
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/NictizSTU3/medication-clientcapabilities CapabilityStatement: Client]
| Medication process client requirements
|-
| Healthcare professional
| The user of a XIS
| XIS
| Healthcare information system
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/NictizSTU3/medication-servercapabilities CapabilityStatement: Server]
| Medication process server requirements
|}

=Use case: retrieve medication overview=
{{FHIR-IG-Afsprakenstelsel-Note}}

==Introduction==
The retrieve medication overview transaction is used by the PHR to retrieve a medication overview from the XIS.

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transaction group'''
! style="text-align:left;"| '''Transaction'''
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Retrieve Medication Overview(PULL)
|style="background-color: white;vertical-align:top;"|Retrieve medication overview request
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Request medication overview from the XIS
|-
|style="background-color: white;vertical-align:top;"|Retrieve medication overview response
|style="background-color: white;vertical-align:top;"|Healthcare professional (using a XIS)
|style="background-color: white;vertical-align:top;"|Serves medication overview to the PHR
|}

==Invocations==
===PHR: request message===
This message uses an extended operation on the RESTful API to obtain a medication overview from a XIS. This operation is used because the XIS needs to play an active role in formulating the content of the response.

====Trigger Events====
When the patient(PHR) wants to obtain the current medication overview, it issues a retrieve medication overview request message.

====Message Semantics====
The PHR executes a medication-overview operation with HTTP POST against the XIS's base endpoint as shown below.

<pre>
POST [base]/$medication-overview
</pre>

=====Expected Actions=====
The XIS shall process the operation to find or generate and return the current medication overview.

===XIS: response message===
The XIS returns a HTTP Status code appropriate to the processing of the operation as well as a Bundle of type 'collection', containing one List and one Patient resource along with other resources that represent the Medication Overview.

====Trigger Events====
The XIS completed processing of the retrieve medication overview request message.

====Message Semantics====
Based on the medication-overview operation processing results, the XIS will either return an error or success. When the XIS needs to report an error, it shall use HTTP error response codes and shall include a FHIR OperationOutcome resource with more details on the failure. If the request message is processed successfully, whether or not a Medication Overview is found or generated, the HTTP status code shall be 200.

The body of the response message shall be a Bundle resource of type "collection". The following section will elaborate on the content included.

If the XIS is sending warnings, the Bundle resource shall also contain a FHIR OperationOutcome resource that contains those warnings. The FHIR specification describes the relevant sections:
*[http://hl7.org/fhir/STU3/http.html RESTful API framework]
*[http://hl7.org/fhir/operations.html Operations]
*[http://hl7.org/fhir/STU3/bundle.html Bundle resource]
*[http://hl7.org/fhir/operationoutcome.html OperationOutcome resource]

=====Message content=====
The outcome of the [https://simplifier.net/NictizSTU3/Medication-Overview medication-overview operation] is the body of the medication overview request message. Successful processing of this operation should result in a Bundle recourse, containing one List and one Patient resource as entries along with all the resources that represent the current medication overview. These resources SHALL be referenced from the List resource. The clinical content of the medication overview is defined in the [https://informatiestandaarden.nictiz.nl/wiki/mp:V9.04_Ontwerp_medicatieproces#Medicatieoverzicht_en_afleidingsregels Medication Process specification]. The functional dataset of the medication overview can be found on [http://decor.nictiz.nl/medicatieproces/mp-html-20170829T141253/tr-2.16.840.1.113883.2.4.3.11.60.20.77.4.148-2016-11-08T103441.html decor.nictiz.nl].

<html>
<iframe width="750" frameborder="1" height="400" src=https://www.simplifier.net/embed/render?id=NictizSTU3-Zib2017/Medication-Overview frameborder="0" align="middle"></iframe>
</html>

The content in the response message SHALL be a valid instance of the following profiles. Clicking on the link will open the formal definition on Simplifier.net.

* '''Bundle profile:''' [https://simplifier.net/NictizSTU3-Zib2017/MedicationOverviewresponsestructure http://nictiz.nl/fhir/StructureDefinition/Bundle-MedicationOverview]
* '''List profile:''' [https://simplifier.net/NictizSTU3-Zib2017/MedicationOverview http://nictiz.nl/fhir/StructureDefinition/MedicationOverview]

The Bundle profile represents the structure of the retrieve medication overview response message. The List profile represents the actual medication overview. The List contains the medication overview metadata and references to all resources that constitute the medication overview. These resources are included in the Bundle as entries. The returned Bundle has at least one List and one Patient resource.

All returned resources to the PHR, including the Bundle and List, SHALL include their related profile canonical URL in the ''meta.profile'' element in order to show compliance. The resources in the response message SHALL be a valid instance of these profiles. In the table below, the ZIB's that constitute the clinical content of the Medication Overview and their respective profiles are listed.

'''Note''' that the medication building blocks are grouped per 'medication treatment' conform the [https://informatiestandaarden.nictiz.nl/wiki/mp:V9.04_Ontwerp_medicatieproces#Medicamenteuze_behandeling Medication Process specification]. Grouping SHALL be done by use of a 'medication treatment' identifier. This identifier shall be the same across different related medication resources that constitute a medication treatment. The [https://simplifier.net/NictizSTU3/zib-Medication-MedicationTreatment zib-Medication-MedicationTreatment extenstion] is added to all medication profiles and can be used for this grouping purpose.

{| class="wikitable"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|ZIB name NL||ZIB name EN||FHIR Resource||FHIR Profile
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Patient
| #ZIB Patient|Patient
| Patient
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
|-
| Zorgverlener
| HealthProfessional
| Practitioner
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
|-
| Zorgaanbieder
| HealthcareProvider
| Organization
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
|-
| Medicatiegebruik||MedicationUsage||MedicationStatement|| [https://simplifier.net/NictizSTU3-Zib2017/ZIB-MedicationUse http://nictiz.nl/fhir/StructureDefinition/zib-MedicationUse]
|-
| Toedieningsafspraak||AdministrationAgreement||MedicationDispense|| [https://simplifier.net/NictizSTU3-Zib2017/ZIB-AdministrationAgreement http://nictiz.nl/fhir/StructureDefinition/zib-AdministrationAgreement]
|-
| Medicatieafspraak||MedicationAgreement||MedicationRequest|| [https://simplifier.net/NictizSTU3-Zib2017/ZIB-MedicationAgreement http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAgreement]
|-
| Product||Product||Medication|| [https://simplifier.net/NictizSTU3-Zib2017/ZIB-Product http://nictiz.nl/fhir/StructureDefinition/zib-Product]
|-
| GebruiksInstructie||InstructionsForUse||Dosage (datatype)|| [https://simplifier.net/NictizSTU3-Zib2017/ZIB-InstructionsForUse http://nictiz.nl/fhir/StructureDefinition/zib-InstructionsForUse]
|-
|}

====Expected Actions====
The PHR processes the results according to application-defined rules. The PHR should be robust as the response may contain medication information resources as mentioned in the former section.

==Interactions, operations, search parameters==
===Interactions===
No interactions are needed for the retrieve medication overview transaction.

===Operations===
The retrieve medication overview medication operation is used for this transaction. The formal definition can be found here:
* [https://simplifier.net/NictizSTU3-Zib2017/Medication-Overview Medication Overview]

===Search parameters===
The following search parameter type needs to be supported for this transaction.

Search parameter types:
* [http://hl7.org/fhir/STU3/search.html#token token]

=Use case: retrieve medication information=
{{FHIR-IG-Afsprakenstelsel-Note}}

==Introduction==
The Retrieve Medication Information transaction is used by the PHR to retrieve medication information from the XIS. The PHR can use this transaction to retrieve the wanted information by searching on specific medication building blocks.

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transaction group'''
! style="text-align:left;"| '''Transaction'''
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Retrieve Medication Information(PULL)
|style="background-color: white;vertical-align:top;"|Retrieve medication information request
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Request medication information from the XIS
|-
|style="background-color: white;vertical-align:top;"|Retrieve medication information response
|style="background-color: white;vertical-align:top;"|Healthcare professional (using a XIS)
|style="background-color: white;vertical-align:top;"|Serves medication information to the PHR
|}

==Invocations==
===PHR: request message===
This message uses the HTTP GET method parameterized query to obtain medication information from a XIS. Multiple different HTTP GET request messages may be needed to retrieve all medication information.

====Trigger Events====
When the patient(PHR) wants to obtain medication information matching various parameters, it issues a retrieve medication information request message.

====Message Semantics====
The PHR executes an HTTP GET against the XIS's medication FHIR endpoints. These endpoints can be one of the following:
* MedicationRequest
* MedicationAdministration
* MedicationDispense
* MedicationStatement

The search interaction is performed by an HTTP GET conform the [http://hl7.org/fhir/STU3/search.html FHIR search specification] as shown:

<pre>
GET [base]/[type]{?[parameters]{&_format=[mime-type]}}
</pre>

This URL is configurable by the PHR by configuring the query search parameters and search control parameters to modify the behavior of the XIS such as response format, or pagination. An example of a search for MedicationRequest resources:

<pre>
GET https://vonk.test-nictiz.nl/MedicationRequest?date=gt2010-10-01
</pre>

This search interaction will finds any MedicationRequest resources changed since 1-Oct 2010.

=====Including other resources in searchresults=====
The PHR may request that the XIS return resources related to the search results, in order to reduce the overall network delay of repeated retrievals of related resources. This is useful when the PHR is searching on a clinical resource, but for every such resource returned, the client will also need the subject (Patient resource) or prescriber (Practitioner resource) or medication that the clinical resource refers to. The client can use the _include parameter to indicate that the subject resources be included in the results. Example search:

<pre>
GET [base]/MedicationRequest?&category=http://snomed.info/sct|16076005&_include:MedicationRequest:medication
</pre>

This search interaction will find all MedicationRequest resources of the category MedicationAgreement and if present includes the referenced Medication resource.

====Query Search Parameters====
The PHR may supply, and the XIS SHALL be capable of processing, all query parameters listed in the table below. The XIS may choose to support additional query parameters beyond the subset listed below. Any additional query parameters supported shall be supported according to the core FHIR specification. Such additional parameters are considered out of scope for this transaction.

{| class="wikitable"
! style="font-weight: bold;text-align:left;" | MP9 search parameters
! style="font-weight: bold;text-align:left;" | Description
! style="font-weight: bold;text-align:left;" | FHIR search parameter
! style="font-weight: bold;text-align:left;" | FHIR resource
|-
| Identification
| Search on identifier.
| identifier
| MedicationRequest, MedicationDispense, MedicationAdministration, MedicationStatement
|-
| Type
| Search on type of medication building block (HCIM).
| category '''*''' / '''**'''
| MedicationRequest, MedicationAdministration, MedicationDispense, MedicationStatement
|-
| ProductCode
| Search on medication code.
| code
| MedicationRequest, MedicationAdministration, MedicationDispense, MedicationStatement, Medication
|-
| UsePeriod
| Search on medication use in the past, present or future within the specified time period.
| periodofuse '''**'''
| MedicationDispense, MedicationRequest
|-
| DispensePeriod
| Returns all medication dispenses within the specific period.
| whenhandedover
| MedicationDispense
|}
'''*''' The FHIR profiles that represent the medication building blocks contain fixed code values in the ''.category'' elements to allow searching on specific medication building blocks. FHIR resources MedicationAdministration and MedicationDispense do not contain a 'category' search parameter in the FHIR specification. Custom search parameters are provided.

'''**''' The search parameter consists of a custom created FHIR search parameter not represented in the FHIR specification.

=====Custom Search Parameters=====

The following custom search parameters are defined for this use case:

* https://simplifier.net/NictizSTU3-Zib2017/Medications-category
* https://simplifier.net/NictizSTU3-Zib2017/Medications-periodofuse

=====Search on fixed category code=====
To distinguish the ZIB medication building blocks between general medication resources, a fixed category coding has been added to the ZIB medication profiles. This fixed category code is solely used for indexing and retrieval of the ZIB building blocks. These category codings be found in the in the profiles at the .category element. The profiles are listed at the response message section below.

====Example Searches====

'''Identifier'''
<pre>1. https://vonk.test-nictiz.nl/MedicationRequest?identifier=http://example.nl/fhir/NamingSystem/MedicationRequest|999922448 </pre>
# Retrieves a MedicationRequest resource with the identifier 999922448.

'''Type'''
<pre>1. https://vonk.test-nictiz.nl/MedicationRequest
2. https://vonk.test-nictiz.nl/MedicationRequest?category=http://snomed.info/sct|16076005</pre>
# Retrieves all MedicationRequest resources.
# Retrieves all MedicationRequest resources that represent a ZIB MedicationAgreement.

'''ProductCode'''
<pre>1. https://vonk.test-nictiz.nl/MedicationRequest?medication.code=urn:oid:2.16.840.1.113883.2.4.4.8|13610554
2. https://vonk.test-nictiz.nl/MedicationRequest?include=Medication:medication&code=urn:oid:2.16.840.1.113883.2.4.4.8|13610554
3. https://vonk.test-nictiz.nl/MedicationRequest?category=http://snomed.info/sct|16076005&medication.code=urn:oid:2.16.840.1.113883.2.4.4.8|13610554</pre>
# Retrieves all MedicationRequest resources that have Carbasalaatcalcium Sandoz 600 30 as medication.
# Retrieves all MedicationRequest resources that have Carbasalaatcalcium Sandoz 600 30 as medication and includes the Medication resource in the search results.
# Retrieves all MedicationRequest resources that represent a ZIB MedicationAgreement and have Carbasalaatcalcium Sandoz 600 30 as medication

'''UsePeriod'''
<pre>1. https://vonk.test-nictiz.nl/MedicationRequest?periodofuse=ge2010-01-01
2. https://vonk.test-nictiz.nl/MedicationDispense?periodofuse=ge2010-01-01&periodofuse=le2011-12-31
3. https://vonk.test-nictiz.nl/MedicationRequest?category=http://snomed.info/sct|16076005&periodofuse=ge2010-01-01</pre>
# Retrieves all MedicationRequest resources that were in effect after 01-01-2010.
# Retrieves all MedicationDispense resources that were in effect within a 2 year period.
# Retrieves all MedicationRequest resources that represent a ZIB MedicationAgreement and were in effect after 01-01-2010.

'''DispensePeriod'''
<pre>1. https://vonk.test-nictiz.nl/MedicationDispense?whenhandedover=ge2010-01-01
2. https://vonk.test-nictiz.nl/MedicationDispense?whenhandedover=ge2010-01-01&whenhandedover=le2011-12-31
3. https://vonk.test-nictiz.nl/MedicationDispense?whenhandedover=ge2010-01-01&category=http://snomed.info/sct|373784005
</pre>
# Retrieves all MedicationDispense resources that were handed over after 01-01-2010.
# Retrieves all MedicationDispense resources that were handed over within a 2 year period.
# Retrieves all MedicationDispense resources that represent a ZIB Dispense and were handed over after 01-01-2010.

=====Expected Actions=====
The XIS shall process the query to discover the medication information that match the search parameters given.

===XIS: response message===
The XIS returns a HTTP Status code appropriate to the processing as well as a FHIR Bundle including the matching medication information.

====Trigger Events====
The XIS completed processing of the Retrieve medication information request message.

====Message Semantics====
Based on the query results, the XIS will either return an error or success. When the XIS needs to report an error, it SHALL use HTTP error response codes and SHOULD include a FHIR OperationOutcome resource with more details on the failure. If the request message is processed successfully, whether or not any medication resources are found, the HTTP status code SHALL be 200.

The response message SHALL be a Bundle resource of type "searchset" containing zero or more FHIR resources as entries. If the XIS is sending warnings, the Bundle resource SHALL also contain a FHIR OperationOutcome resource that contains those warnings. The FHIR specification describes the relevant sections:
*[http://hl7.org/fhir/STU3/http.html RESTful API framework]
*[http://hl7.org/fhir/STU3/search.html#errors Search errors]
*[http://hl7.org/fhir/STU3/bundle.html Bundle resource]
*[http://hl7.org/fhir/operationoutcome.html OperationOutcome resource]

=====Message resource content=====
The returned data to the PHR should conform to the medication ZIBs profiles. In the table below the medication ZIB's and their respective FHIR profiles are listed. The resources in the response message SHALL be a valid instance of these profiles. All resources SHALL include their related profile canonical URL in the ''meta.profile'' element in order to show compliance.

'''Note''' that the medication building blocks are grouped per 'medication treatment' conform the [https://informatiestandaarden.nictiz.nl/wiki/mp:V9.04_Ontwerp_medicatieproces#Medicamenteuze_behandeling Medication Process specification]. Grouping SHALL be done by use of a 'medication treatment' identifier. This identifier shall be the same across different related medication resources that constitute a medication treatment. The [https://simplifier.net/NictizSTU3-Zib2017/ZIB-MedicationTreatment zib-Medication-MedicationTreatment extension] is added to all medication profiles and can be used for this grouping purpose.

{| class="wikitable" width="1400px"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|ZIB name NL||ZIB name EN||FHIR Resource||FHIR Profile
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Patient
| #ZIB Patient|Patient
| Patient
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
|-
| Zorgverlener
| HealthProfessional
| Practitioner
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
|-
| Zorgaanbieder
| HealthcareProvider
| Organization
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
|-
| Medicatiegebruik||MedicationUsage||MedicationStatement|| [https://simplifier.net/NictizSTU3-Zib2017/ZIB-MedicationUse http://nictiz.nl/fhir/StructureDefinition/zib-MedicationUse]
|-
| Medicatietoediening||MedicationAdministration||MedicationAdministration|| [https://simplifier.net/NictizSTU3-Zib2017/ZIB-MedicationAdministration http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAdministration]
|-
| Toedieningsafspraak||AdministrationAgreement||MedicationDispense|| [https://simplifier.net/NictizSTU3-Zib2017/ZIB-AdministrationAgreement http://nictiz.nl/fhir/StructureDefinition/zib-AdministrationAgreement]
|-
| Medicatieafspraak||MedicationAgreement||MedicationRequest|| [https://simplifier.net/NictizSTU3-Zib2017/ZIB-MedicationAgreement http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAgreement]
|-
| Verstrekking||Dispense||MedicationDispense|| [https://simplifier.net/NictizSTU3-Zib2017/ZIB-Dispense http://nictiz.nl/fhir/StructureDefinition/zib-Dispense]
|-
| Verstrekkingsverzoek||MedicationDispenseRequest||MedicationRequest|| [https://simplifier.net/NictizSTU3-Zib2017/ZIB-DispenseRequest http://nictiz.nl/fhir/StructureDefinition/zib-DispenseRequest]
|-
| Product||Product||Medication|| [https://simplifier.net/NictizSTU3-Zib2017/ZIB-Product http://nictiz.nl/fhir/StructureDefinition/zib-Product]
|-
| GebruiksInstructie||InstructionsForUse||Dosage (datatype)|| [https://simplifier.net/NictizSTU3-Zib2017/ZIB-InstructionsForUse http://nictiz.nl/fhir/StructureDefinition/zib-InstructionsForUse]
|-
|}

====Expected Actions====
The PHR shall process the results according to application-defined rules. The PHR should be robust as the response may contain medication information resources that match the query parameters.

==Interactions, operations, search parameters==
===Interactions===
The following logical interactions are needed for the retrieve medication information transaction:
* [http://hl7.org/fhir/STU3/http.html#search Search]

===Operations===
No operations are defined or needed for this transaction.

===Search parameters===
The following search parameter types and search result parameters need to be supported for this transaction.

Search parameter types:
* [http://hl7.org/fhir/STU3/search.html#token token]
* [http://hl7.org/fhir/STU3/search.html#date date]

Search result parameters:
* [http://hl7.org/fhir/STU3/search.html#include _include]

[[categorie:MedMij FHIR Use Cases]]

MedMij:V2018.04 FHIR BGZ 2017

2018-08-30T12:55:58Z

Marten Smits:

{{#customtitle:MedMij FHIR use case BgZ 2017}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:BGZ_icoon.png |link=|links|90px|Use case BgZ 2017|Patient Summary (BgZ)]]
<imagemap>Bestand:Leeswijzer-technisch-banner 03 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.04_OntwerpBGZ_2017|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.04_FHIR_IG|Technisch]]
desc none
</imagemap>

__TOC__

==Introduction==
[[Bestand:Functioneel-02.png|link=MedMij:V2018.04_Ontwerpen |100px|rechts|Functional design|Go to functional design]]

The program ‘Registratie aan de bron’ (Data capture at the point of Care) has defined Health and Care Information models ([https://zibs.nl/wiki/HCIM_Mainpage HCIMs] (English) or [https://zibs.nl/wiki/ZIB_Hoofdpagina ZIBs] (Dutch)) for The Netherlands. Next to these HCIMs, the program ‘Registratie aan de bron’ also made a selection of these HCIMs into the so-called ‘Basisgegevensset Zorg’ (Common Clinical Dataset, a Dutch version of a ‘patient summary’, further referred to as ‘BgZ’). The BgZ serves as a minimal healthcare dataset that is always appropriate for caregivers in order to provide continuity of care for a patient and can be seen as a representation of a patient summary.

A subselection of the published [https://zibs.nl/wiki/HCIM_Release_2017(EN) HCIMs release 2017] constitute the [https://www.registratieaandebron.nl/pdf/BgZ_specificatie_obv_zibs_2017_v1.0.pdf BgZ 2017]. The BgZ makes a subselection of the information concepts within the HCIMs or restricts the HCIMs to a certain category. For example, only include the general practitioner of the patient or only the last known value of 'X'. MedMij created FHIR profiles that represent these HCIMs completely if no existing and usable profiles were available. The profiles represent their entire respective HCIM, to make them applicable in a broader context than a patient summary or even the MedMij context. An overview of the profiles can be found at the [[MedMij:V2018.04_FHIR_BGZ_2017#List_of_StructureDefinitions|list of StructureDefinitions]].

The patient journey of [https://www.nictiz.nl/ehealth/MedMij Thomas van Beek], provides a patients context for exchanging a patient summary from a healthcare provider's system (XIS) to a personal health record (PHR). MedMij created a [https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.04_Ontwerpen functional design] of the BgZ use case. This use case consists of enabling a patient to view his own BgZ in a PHR. This page will elaborate further on the HL7 FHIR details needed to exchange the BgZ information using FHIR.

==Actors involved==
{| class="wikitable"
! colspan="2" style="text-align:left;" | Actors
! colspan="2" style="text-align:left;" | Systems
! colspan="2" style="text-align:left;" | FHIR Capability Statements
|-
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
|-
| Patient
| The user of a personal healthcare enviorment.
| PHR
| Personal health record
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/NictizSTU3-Zib2017/bgz2017-clientcapabilities CapabilityStatement: Client]
| FHIR Client requirements
|-
| Healthcare professional
| The user of a XIS
| XIS
| Healthcare information system
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/NictizSTU3-Zib2017/bgz2017-servercapabilities CapabilityStatement: Server]
| FHIR Server requirements
|}

==Boundaries and Relationships==
The BgZ 2017 use case follows the BgZ 1.0 use case. The difference between the two is the underlying HCIMs, which have been upgraded from release 2015 to release 2017.

Release notes can be found here:https://github.com/Nictiz/Nictiz-STU3-Zib2017/raw/master/ReleaseNotes%20FHIR%20profielen%20ZIB2017.pdf

The BgZ use case has similarities and differences with other use cases such as Medication Process, Vital Signs and Lab Results. These use cases use the same HCIM based FHIR profiles for exchanging information. The BgZ use case covers practically all profiles included in the other use cases. However, the BgZ differs in the scope of the actual health information content that should be exchanged. For example, the BgZ conveys only the last known lab result of each type while the Lab Results use case may cover all known information.

==List of invocations==
[[Bestand:Afsprakenstelsel-01.png|link=https://www.medmij.nl/afsprakenstelsel/|rechts |100px|Go to Afsprakenstelsel]]

This FHIR implementation guide assumes that the PHR system is able to make a connection to the XIS that contains the patients BgZ information. It does not provide information on finding the right XIS nor does it provide information about security. These infrastructure and interface specifications are described in the [https://www.medmij.nl/afsprakenstelsel/ 'Afsprakenstelsel'].

===Client - PHR===
The PHR system requests the BgZ using individual search interactions. The BgZ consists of multiple FHIR resources with certain constraints. To obtain the patient's BgZ, the client can use multiple individual search operations based on specified search queries. The interaction can be performed by an HTTP GET or command as shown:

<code>GET [base]/[type]/{?[parameters]{&_format=[mime-type]}}</code>

The table below shows in the first four columns the BgZ sections, the HCIMs that constitute those sections and the specific content of the BgZ. The last column shows the FHIR search queries to obtain the BgZ information. These queries are based on StructureDefinitions listed in [[#List_of_StructureDefinitions| this section]].

Each query is performed in the context of a specific authenticated patient, for which an OAuth2 token has been retrieved using the Authentication mechanisms described in the [https://www.medmij.nl/afsprakenstelsel/ 'Afsprakenstelsel']. This token must be passed in each call in the HTTP header named “Authorization”. Each XIS Gateway is required to perform filtering based on the patient associated with the OAuth2 token received for the request, so that only the records associated with the authenticated patient are returned. Therefore, no search parameters should be passed for patient identification.
{| class="wikitable collapsible" width="100%" style="horizontal-align: right"
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | #
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | BgZ Section
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | HCIM EN
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | Content
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | Example Search URL
|-
| 1
| Patient information
| Patient
| Identification, birthdate, gender, deceasedindicator, contact details, marital status, and general practitioner (practitioner or organization)
| <pre>GET [base]/Patient?_include=Patient:general-practitioner</pre>
|-
| 2
| Payment details
| Payer
| Insurance information
| <pre>GET [base]/Coverage?_include=Coverage:payor:Patient&_include=Coverage:payor:Organization</pre>
|-
| rowspan="2" | 3
| rowspan="2" | Treatment Directives
| TreatmentDirective
| Known treatment directives
| <pre>GET [base]/Consent?category=http://snomed.info/sct|11291000146105</pre>
|-
| Advance directive
| Known advance directives
| <pre>GET [base]/Consent?category=http://snomed.info/sct|11341000146107</pre>
|-
| 4
| Contactperson
| Contact
| First relation/contact
| <pre style="font-style: italic;">see Patient</pre>
|-
| 5
| Functional status
| FunctionalOrMentalStatus
| Last known functional / mental status
| <pre>GET [base]/Observation$lastn?category=http://snomed.info/sct|118228005,http://snomed.info/sct|364644000</pre>
|-
| 6
| Problems
| Concern
| All known problems.
| <pre>GET [base]/Condition</pre>
|-
| rowspan="5" | 7
| rowspan="5" | Social history
| LivingSituation
| Current living situation
| <pre>GET [base]/Observation/$lastn?code=http://snomed.info/sct|365508006</pre>
|-
| DrugUse
| All known drug use
| <pre>GET [base]/Observation?code=http://snomed.info/sct|228366006</pre>
|-
| AlcoholUse
| All known alcohol use
| <pre>GET [base]/Observation?code=http://snomed.info/sct|228273003</pre>
|-
| TobaccoUse
| All known tobacco use
| <pre>GET [base]/Observation?code=http://snomed.info/sct|365980008</pre>
|-
| NutritionAdvice
| All known current dietary recommendations
| <pre>GET [base]/NutritionOrder?status=active</pre>
|-
| 8
| Alerts
| Alert
| All known alerts
| <pre>GET [base]/Flag</pre>
|-
| 9
| Allergies
| AllergyIntolerance
| All known information regarding allergies
| <pre>GET [base]/AllergyIntolerance</pre>
|-
| rowspan="3" | 10
| rowspan="3" | Medication
| MedicationUse
| Known medication use
| <pre>GET [base]/MedicationStatement?category=urn:oid:2.16.840.1.113883.2.4.3.11.60.20.77.5.3|6&_include=MedicationStatement:medication</pre>
|-
| MedicationAgreement
| Known medication agreements
| <pre>GET [base]/MedicationRequest?category=http://snomed.info/sct|16076005&_include=MedicationRequest:medication</pre>
|-
| AdministrationAgreement
| Known administration agreements
| <pre>GET [base]/MedicationDispense?category=http://snomed.info/sct|422037009&_include=MedicationDispense:medication</pre>
|-
| 11
| Medical aids
| MedicalAid
| All known medicalaids
| <pre>GET [base]/DeviceUseStatement?_include=DeviceUseStatement:device</pre>
|-
| 12
| Vaccinations
| Vaccination
| All known vaccinations
| <pre>GET [base]/Immunization?status=completed</pre>
|-
| rowspan="3" | 13
| rowspan="3" | Vital signs
| BloodPressure
| Last known bloodpressure
| <pre>GET [base]/Observation/$lastn?code=http://loinc.org|85354-9</pre>
|-
| BodyWeight
| Last known body weight
| <pre>GET [base]/Observation/$lastn?code=http://loinc.org|29463-7</pre>
|-
| BodyHeight
| Last known body height
| <pre>GET [base]/Observation/$lastn?code=http://loinc.org|8302-2,http://loinc.org|8306-3,http://loinc.org|8308-9</pre>
|-
| 14
| Results
| LaboratoryTestResult
| Last known laboratory results per type
| <pre>GET [base]/Observation/$lastn?category=http://snomed.info/sct|275711006&_include=Observation:related-target&_include=Observation:specimen</pre>
|-
| 15
| Procedures
| Procedure
| All surgical procedures
| <pre>GET [base]/Procedure?category=http://snomed.info/sct|387713003</pre>
|-
| 16
| Encounters
| Contact
| All hospital admissions (no outpatient contacts)
| <pre>GET [base]/Encounter?class=http://hl7.org/fhir/v3/ActCode|IMP,http://hl7.org/fhir/v3/ActCode|ACUTE,http://hl7.org/fhir/v3/ActCode|NONAC</pre>
|-
| rowspan="5" | 17
| rowspan="5" | Planned care
| rowspan="5" | PlannedCareActivity
| rowspan="5" | All known planned care activities
| <pre>GET [base]/ProcedureRequest?status=active</pre>
|-
| <pre>GET [base]/ImmunizationRecommendation</pre>
|-
| <pre>GET [base]/MedicationDispense?category=http://snomed.info/sct|422037009&status=in-progress,preparation&_include=MedicationDispense:medication</pre>
|-
| <pre>GET [base]/DeviceRequest?status=active_include=DeviceRequest:device</pre>
|-
| <pre>GET [base]/Appointment?status=booked,pending,proposed</pre>
|-
| 18
| General practitioner
| HealthProfessional
| General Practitioner of the patient
| <pre style="font-style: italic;">see Patient</pre>
|}

===Server - XIS===
Important sections of the FHIR specification for a server in this use case are the [http://hl7.org/fhir/STU3/http.html#2.21.0 RESTful API section] the [http://hl7.org/fhir/STU3/search.html search section] and [http://hl7.org/fhir/STU3/operations.html operation section] (for the nlast operation).

====Response to resource requests====
If the search succeeds, the server SHALL return a 200 OK HTTP status code and the returned content SHALL be a Bundle with type = searchset containing the results of the search as a collection of zero or more resources in a defined order. The returned content should conform to the StructureDefinition applicable for the specific HCIM request. The list of a StructureDefinitions relevant for this use case is shown in the following paragraph: [[#List_of_StructureDefinitions | List of StructureDefinitions]]

The result collection can be long, so servers may use paging. If they do, they SHALL use the method described below (adapted from RFC 5005 (Feed Paging and Archiving ) for breaking the collection into pages if appropriate. The server MAY also return an [http://hl7.org/fhir/stu3/operationoutcome.html OperationOutcome resource] within the searchset Bundle entries that contains additional information about the search; if one is sent it SHALL NOT include any issues with a fatal or error severity, and it SHALL be marked with a Bundle.entry.search.mode of outcome.

In order to allow the client to be confident about what search parameters were used as criteria by the server, the server SHALL return the parameters that were actually used to process the search. Applications processing search results SHALL check these returned values where necessary. For example, if the server did not support some of the filters specified in the search, a client might manually apply those filters to the retrieved result set, display a warning message to the user or take some other action.

In the case of a RESTful search, these parameters are encoded in the self-link in the bundle that is returned:
<pre>
<link>
<relation value="self"/>
<url value="http://example.org/Patient?identifier=[Patient-ID]/>
</link>
</pre>

Link to the relevant FHIR specification: http://hl7.org/fhir/STU3/http.html#search

====Handling errors====
If the search fails '''(cannot be executed, not that there are no matches)''', the return value is a status code 4xx or 5xx with an OperationOutcome. An HTTP status code of 403 signifies that the server refused to perform the search, while other 4xx and 5xx codes signify that some sort of error has occurred. The HTTP status code 404 is returned if a XIS did not implement an endpoint used in a request by a PHR. When the search fails, a server SHOULD return an OperationOutcome detailing the cause of the failure. For example, in case of a not implemented FHIR endpoint, the OperationOutcome would state that the resource type is not supported. Note: an empty search result is not a failure.

Common HTTP Status codes returned on FHIR-related errors (in addition to normal HTTP errors related to security, header and content type negotiation issues):

* 400 Bad Request - search could not be processed or failed basic FHIR validation rules
* 401 Not Authorized - authorization is required for the interaction that was attempted
* 404 Not Found - resource type not supported, or not a FHIR end-point

In some cases, parameters may cause an error. For instance:

* A parameter may refer to a non-existent resource e.g. <code>GET [base]/Observation?subject=101</code>, where "101" does not exist
* A parameter may refer to an unknown code e.g. <code>GET [base]/Observation?code=loinc|1234-1</code>, where the LOINC code "1234-1" is not known to the server
* A parameter may refer to a time that is out of scope e.g. <code>GET [base]/Condition?onset=le1995</code>, where the system only has data going back to 2001
* A parameter may use an illegal or unacceptable modifier e.g. <code>GET [base]/Condition?onset:text=1995</code>, where the modifier cannot be processed by the server
* A data time parameter may have incorrect format e.g. <code>GET [base]/Condition?onset=23%20May%202009</code>
* A parameter may be unknown or unsupported
Where the content of the parameter is syntactically incorrect, servers SHOULD return an error. However, where the issue is a logical condition (e.g. unknown subject or code), the server SHOULD process the search, including processing the parameter - with the result of returning an empty search set, since the parameter cannot be satisfied.

In such cases, the search process MAY include an OperationOutcome in the search set that contains additional hints and warnings about the search process. This is included in the search results as an entry with search mode = outcome. Clients can use this information to improve future searches.

Link to relevant FHIR specification: http://hl7.org/fhir/STU3/search.html#errors

==Interactions, operations, search parameters==

===Interactions===

The following logical interactions are needed for the BgZ use case:
* [http://hl7.org/fhir/STU3/http.html#search Search]

===Operations===
The following [http://hl7.org/fhir/STU3/operations.html operation] is needed to support this use case.
* [http://hl7.org/fhir/STU3/observation-operations.html#lastn Last N Observations Query]

The lastn query meets the common need for searching for the most recent or last n=number of observations for a subject. For example, retrieving the last 5 temperatures for a patient to view trends or fetching the most recent laboratory results or vital signs. The link will provide more detailed information and examples regarding this operation.

===Search parameters===
The following search parameter types and search result parameters need to be supported for this use case.

Search parameter types:
* [http://hl7.org/fhir/STU3/search.html#token token]
** Including modifier 'in'
* [http://hl7.org/fhir/STU3/search.html#reference reference]

Search result parameters:
* [http://hl7.org/fhir/STU3/search.html#include _include]
* [http://hl7.org/fhir/STU3/search.html#include _revinclude]

==List of StructureDefinitions==
The profiles represent their entire respective HCIM, to make them applicable in a broader context than the exchange of BgZ or a MedMij context. An example of reuse of existing profiles are those of the patient administration resources and vital signs.

{| class="wikitable" style="horizontal-align: right"
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | Section
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:100px" | ZIB NL
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:100px" | HCIM EN
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:100px" | FHIR Resource
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:400px" | FHIR Profile
|-
| 01
| Patient
| #ZIB Patient|Patient
| Patient
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
|-
| rowspan="3" |02
| rowspan="3" | Betaler
| rowspan="3" | Payer
| Coverage
| [https://simplifier.net/NictizSTU3-Zib2017/zib-Payer http://nictiz.nl/fhir/StructureDefinition/zib-Payer]
|-
| Organization
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
|-
| Patient
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
|-
| rowspan="2" |03
| BehandelAanwijzing
| TreatmentDirective
| Consent
| [https://simplifier.net/NictizSTU3-Zib2017/zib-TreatmentDirective http://nictiz.nl/fhir/StructureDefinition/zib-TreatmentDirective]
|-
| Wilsverklaring
| AdvanceDirective
| Consent
| [https://simplifier.net/NictizSTU3-Zib2017/zib-AdvanceDirective http://nictiz.nl/fhir/StructureDefinition/zib-AdvanceDirective]
|-
| 04
| Contactpersoon
| Contact
| RelatedPerson
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-relatedperson http://fhir.nl/fhir/StructureDefinition/nl-core-relatedperson]
|-
| 05
| Funct. OfMentaleStatus
| FunctionalOrMentalStatus
| Observation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-FunctionalOrMentalStatus http://nictiz.nl/fhir/StructureDefinition/zib-FunctionalOrMentalStatus]
|-
| 06
| Probleem
| Problem
| Condition
| [https://simplifier.net/NictizSTU3-Zib2017/zib-Problem http://nictiz.nl/fhir/StructureDefinition/zib-Problem]
|-
| rowspan="5" | 07
| Woonsituatie
| LivingSituation
| Observation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-LivingSituation http://nictiz.nl/fhir/StructureDefinition/zib-LivingSituation]
|-
| DrugsGebruik
| DrugUse
| Observation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-DrugUse http://nictiz.nl/fhir/StructureDefinition/zib-DrugUse]
|-
| AlcoholGebruik
| AlcoholUse
| Observation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-AlcoholUse http://nictiz.nl/fhir/StructureDefinition/zib-AlcoholUse]
|-
| TabakGebruik
| TobaccoUse
| Observation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-TobaccoUse http://nictiz.nl/fhir/StructureDefinition/zib-TobaccoUse]
|-
| Voedingsadvies
| NutritionAdvice
| NutritionOrder
| [https://simplifier.net/NictizSTU3-Zib2017/zib-NutritionAdvice http://nictiz.nl/fhir/StructureDefinition/zib-NutritionAdvice]
|-
| 08
| Alert
| Alert
| Flag
| [https://simplifier.net/NictizSTU3-Zib2017/zib-Alert http://nictiz.nl/fhir/StructureDefinition/zib-Alert]
|-
| 09
| AllergieIntolerantie
| AllergyIntolerance
| AllergyIntolerance
| [https://simplifier.net/NictizSTU3-Zib2017/zib-AllergyIntolerance http://nictiz.nl/fhir/StructureDefinition/zib-AllergyIntolerance]
|-
| rowspan="3" | 10
| rowspan="3" | MedicatieGebruik
| MedicationUse
| MedicationStatement
| [https://simplifier.net/NictizSTU3/zib-MedicationUse http://nictiz.nl/fhir/StructureDefinition/zib-MedicationUse]
|-
| MedicationAgreement
| MedicationRequest
| [https://simplifier.net/NictizSTU3/zib-MedicationAgreement http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAgreement]
|-
| AdministrationAgreement
| MedicationDispense
| [https://simplifier.net/NictizSTU3/zib-AdministrationAgreement http://nictiz.nl/fhir/StructureDefinition/zib-AdministrationAgreement]
|-
| rowspan="2" | 11
| rowspan="2" | MedischHulpmiddel
| rowspan="2" | MedicalDevice
| Device
| [https://simplifier.net/NictizSTU3-Zib2017/ZIB-MedicalDevice-Product http://nictiz.nl/fhir/StructureDefinition/zib-MedicalDeviceProduct]
|-
| DeviceUseStatement
| [https://simplifier.net/NictizSTU3-Zib2017/zib-MedicalDevice http://nictiz.nl/fhir/StructureDefinition/zib-MedicalDevice]
|-
| rowspan="2" | 12
| rowspan="2" | Vaccinatie
| rowspan="2" | Vaccination
| Immunization
| [https://simplifier.net/NictizSTU3-Zib2017/zib-Vaccination http://nictiz.nl/fhir/StructureDefinition/zib-Vaccination]
|-
| ImmunizationRecommendation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-VaccinationRecommendation http://nictiz.nl/fhir/StructureDefinition/zib-VaccinationRecommendation]
|-
| rowspan="3" | 13
| Bloeddruk
| BloodPressure
| Observation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-BloodPressure http://nictiz.nl/fhir/StructureDefinition/zib-BloodPressure]
|-
| LichaamsGewicht
| BodyWeight
| Observation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-BodyWeight http://nictiz.nl/fhir/StructureDefinition/zib-BodyWeight]
|-
| LichaamsLengte
| BodyHeight
| Observation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-BodyHeight http://nictiz.nl/fhir/StructureDefinition/zib-BodyHeight]
|-
| rowspan="2" | 14
| rowspan="2" | LaboratoriumUitslag
| rowspan="2" | LaboratoryTestResult
| Observation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-LaboratoryTestResult-Observation http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Observation]
|-
| Specimen
| [https://simplifier.net/NictizSTU3-Zib2017/zib-LaboratoryTestResult-Specimen http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Specimen]
|-
| 15
| Verrichting
| Procedure
| Procedure
| [https://simplifier.net/NictizSTU3-Zib2017/zib-Procedure http://nictiz.nl/fhir/StructureDefinition/zib-Procedure]
|-
| 16
| Contact
| Encounter
| Encounter
| [https://simplifier.net/NictizSTU3-Zib2017/zib-Encounter http://nictiz.nl/fhir/StructureDefinition/zib-Encounter]
|-
| rowspan="5" | 17
| rowspan="5" | GeplandeZorgActiviteit
| rowspan="5" | PlannedCareActivity
| ProcedureRequest
| [https://simplifier.net/NictizSTU3-Zib2017/zib-ProcedureRequest http://nictiz.nl/fhir/StructureDefinition/zib-ProcedureRequest]
|-
| MedicationRequest
| [https://simplifier.net/NictizSTU3/zib-MedicationAgreement http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAgreement]
|-
| ImmunizationRecommendation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-VaccinationRecommendation http://nictiz.nl/fhir/StructureDefinition/zib-VaccinationRecommendation]
|-
| DeviceRequest
| [https://simplifier.net/NictizSTU3-Zib2017/zib-MedicalDevice-Request http://nictiz.nl/fhir/StructureDefinition/zib-MedicalDeviceRequest]
|-
| Appointment
| [https://simplifier.net/NictizSTU3/eAfspraken-Appointment http://nictiz.nl/fhir/StructureDefinition/eAfspraken-Appointment]
|-
| rowspan="3" | 18
| rowspan="2" | Zorgverlener
| rowspan="2" | HealthProfessional
| Practitioner
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
|-
| PractitionerRole
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-practitionerrole http://fhir.nl/fhir/StructureDefinition/nl-core-practitionerrole]
|-
| Zorgaanbieder
| HealthcareProvider
| Organization
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
|}

==Terminology, NamingSystems, Mappings==

===Terminology===
Relevant value sets can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=ValueSet here]. All resources can be downloaded in a .zip in XML or JSON format. In the .zip, the value sets are stored in the directory 'value sets'.

===NamingSystems===
Relevant NamingSystems can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=NamingSystem here].

===Mappings===
Relevant HCIM to FHIR value set mappings can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=ConceptMap here].
All profiles include HCIM mappings. HCIM concepts are mapped to the corresponding FHIR elements using the HCIMs concept id. The top of the StructureDefinition contains meta information regarding the HCIM mapping, such as the name and uri of the HCIM. In the StructureDefinition elements, the corresponding HCIM ID is given including the mapping meta information id. This is illustrated in the following example.

<pre>
<StructureDefinition>
<id value="nl-core-patient" />
.....
<mapping>
<identity value="hcim-patient-v3.1-2017EN"/>
<uri value="https://zibs.nl/wiki/Patient-v3.1(2017EN)"/>
<name value="HCIM Patient-v3.1(2017EN)"/>
</mapping>
.....
<element id="Patient.name">
<path value="Patient.name" />
<short value="NameInformation" />
<alias value="Naamgegevens" />
<type>
<code value="HumanName" />
<profile value="http://fhir.nl/fhir/StructureDefinition/nl-core-humanname" />
</type>
<mapping>
<identity value="hcim-patient-v3.1-2017EN"/>
<map value="NL-CM:0.1.6"/>
</mapping>
</element>
.....
</StructureDefinition>
</pre>

[[categorie:MedMij FHIR Use Cases]]

MedMij:V2018.04 FHIR eAfspraak

2018-08-30T12:55:40Z

Marten Smits:

{{#customtitle:MedMij FHIR Implementation Guide - eAfspraak}}

[[Bestand:EAfspraak_icoon_zonder_tekst.png |link=|links |87px|eAfspraak]]
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 03 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.04_OntwerpeAfspraken|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.04_FHIR_IG|Technisch]]
desc none
</imagemap>

__TOC__

=Introduction=
This page describes how a patient can manage his health care related appointments in a MedMij context using the HL7 FHIR Standard. Initially, this guide will contain information on how to request existing appointment information. Guidance on how to create, update, or cancel appointments will be available here as well at a later stage.
The functional requirements for this use case can be found in the [[MedMij:V2018.04_Ontwerpen|functional design]].

=Use case: retrieve appointments=
[[Bestand:Afsprakenstelsel-01.png|link=https://www.medmij.nl/afsprakenstelsel/|rechts |128px|Go to Afsprakenstelsel]]
{{FHIR-IG-Afsprakenstelsel-Note}}

==Introduction==
The goal of this use case is to give patients an overview of their appointments with all healthcare providers. The appointment information that is shared with the patient will contain start and end date/time, location, type of appointment, patient instructions, health care professionals present. Below is described how a PHR can retrieve this information and how a XIS should make this information available.

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Request appointments from the XIS
|-
|style="background-color: white;vertical-align:top;"|Healthcare professional (using a XIS)
|style="background-color: white;vertical-align:top;"|Serves appointments to the PHR
|}

==Invocations==
===Client - PHR===

====Search for appointments ====
The PHR system can request the appointments using individual search interactions. The search interaction searches for appointments based on '''start''' date/time. The interaction can be performed by an HTTP GET as shown:

<code>GET [base]/Appointment/?date=[date]</code>

for more information on how to query on dates using FHIR see [http://hl7.org/fhir/stu3/search.html#date| the FHIR search specification]

'''examples:'''

retrieve appointments with a start date/time from 01-01-2018 onwards:

<code>GET [base]/Appointment/?date=gt2017-12-31</code>

retrieve appointments with a start date/time from 01-01-2018 until 01-03-2018

<code>GET [base]/Appointment/?date=ge2018-01-01&date=lt2018-03-01</code>

===Server - XIS===
Important sections of the FHIR specification for a server in this use case are the [http://hl7.org/fhir/STU3/http.html#2.21.0 RESTful API section] the [http://hl7.org/fhir/STU3/search.html search section].

====Response on search request====
If the search succeeds, the server SHALL return a 200 OK HTTP status code and the returned content SHALL be a Bundle with type = searchset containing the results of the search as a collection of zero or more resources in a defined order. The result collection can be long, so servers may use paging. If they do, they SHALL use the method described below (adapted from RFC 5005 (Feed Paging and Archiving ) for breaking the collection into pages if appropriate. The server MAY also return an [http://hl7.org/fhir/operationoutcome.html OperationOutcome resource] within the searchset Bundle entries that contains additional information about the search; if one is sent it SHALL NOT include any issues with a fatal or error severity, and it SHALL be marked with a Bundle.entry.search.mode of outcome.

In order to allow the client to be confident about what search parameters were used as criteria by the server, the server SHALL return the parameters that were actually used to process the search. Applications processing search results SHALL check these returned values where necessary. For example, if the server did not support some of the filters specified in the search, a client might manually apply those filters to the retrieved result set, display a warning message to the user or take some other action.

Link to the relevant FHIR specification: http://hl7.org/fhir/STU3/http.html#search

====Handling errors====
If the search fails (cannot be executed, not that there are no matches), the return value is a status code 4xx or 5xx with an OperationOutcome. An HTTP status code of 403 signifies that the server refused to perform the search, while other 4xx and 5xx codes signify that some sort of error has occurred. When the search fails, a server SHOULD return an OperationOutcome detailing the cause of the failure. Note: An empty search result is not a failure.

In some cases, parameters may cause an error. For instance:

* A parameter may refer to a non-existent resource e.g. <code>GET [base]/Appointment?patient=101</code>, where "101" does not exist
* A parameter may refer to an unknown code e.g. <code>GET [base]/Appointment?appointment-type=83280</code>, where the 83280 is not known to the server
* A parameter may refer to a time that is out of scope e.g. <code>GET [base]/Appointment?date=le1995</code>, where the system only has data going back to 2001
* A date/time parameter may have incorrect format e.g. <code>GET [base]/Appointment?date=23%20May%202009</code>
* A parameter may be unknown or unsupported
Where the content of the parameter is syntactically incorrect, servers SHOULD return an error. However, where the issue is a logical condition (e.g. unknown subject or code), the server SHOULD process the search, including processing the parameter - with the result of returning an empty search set, since the parameter cannot be satisfied.

In such cases, the search process MAY include an OperationOutcome in the search set that contains additional hints and warnings about the search process. This is included in the search results as an entry with search mode = outcome. Clients can use this information to improve future searches.

Common HTTP Status codes returned on FHIR-related errors (in addition to normal HTTP errors related to security, header and content type negotiation issues):

* 400 Bad Request - search could not be processed or failed basic FHIR validation rules
* 401 Not Authorized - authorization is required for the interaction that was attempted
* 404 Not Found - resource type not supported, or not a FHIR end-point

Link to relevant FHIR specification: http://hl7.org/fhir/STU3/search.html#errors

==Interactions, operations, search parameters==
===Interactions===
The following FHIR interactions are needed to retrieve appointment information:
* [http://hl7.org/fhir/STU3/http.html#search Search]

===Operations===
No operations are defined or needed for this transaction.

===Search parameters===
{| class="wikitable" width="1400px"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|Name||Type||Description||Expression
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| date
| [http://hl7.org/fhir/stu3/search.html#date date]
| Appointment date/time.
| Appointment.start
|-
|}

==Profiles==
{| class="wikitable" width="1400px"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|Name NL||Name EN||FHIR Resource||URL profile
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Patient
| #ZIB Patient|Patient
| Patient
| [https://simplifier.net/NictizSTU3-zib2017/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
|-
| Zorgverlener
| HealthProfessional
| Practitioner
| [https://simplifier.net/NictizSTU3-zib2017/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
|-
| Zorgaanbieder
| HealthcareProvider
| Organization
| [https://simplifier.net/NictizSTU3-zib2017/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
|-
| Afspraak
| Appointment
| Appointment
| [https://simplifier.net/NictizSTU3-zib2017/eAfspraken-Appointment http://nictiz.nl/fhir/StructureDefinition/eAfspraak-Appointment]
|-
|}

==Examples==

=Use case: book an appointment=

==Introduction==
The goal of this use case is to allow patients to book an appointment at a certain selected health care provider. Below is described how a PHR can send an appointment request and how a XIS should handle this.

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Book appointment
|-
|style="background-color: white;vertical-align:top;"|Healthcare professional (using a XIS)
|style="background-color: white;vertical-align:top;"|Handles appointment request
|}

==Invocations==
===Client - PHR===

====Search for available slots ====
The PHR system can request available slots using the [[#Operations2|$prefetch operation]] with optional input parameters on the Slot endpoint. This operation is a request for the XIS to calculate available slots, and return a Bundle with available slots. The operation can be performed by an HTTP POST as shown:

<code>POST [base]/Slot/$prefetch</code>

The optional input parameters can be put in the request body using the Parameters resource. The full specification of the $prefetch operation is described here:
[[#Operations2|$prefetch operation]]

Below is an example of an operation that requests Slots with a start date/time between July 15th 8PM and July 17th 8PM:

'''example body'''

<pre>
{
"resourceType": "Parameters",
"parameter": [
{
"name": "start",
"valueDateTime" : "2017-07-15T20:00:00Z"
},
{
"name": "end",
"valueDateTime" : "2017-07-17T20:00:00Z"
}
]
}
</pre>

A Bundle containing the available Slot resources and an optional [http://hl7.org/fhir/stu3/operationoutcome.html OperationOutcome] resource can be expected as return.

For more information on how operations work using FHIR see [http://hl7.org/fhir/stu3/operations.html the FHIR search specification]

====Book appointment====

After fetching open Slots, an Appointment resource is created by the Client Application and is exchanged with the EHR. This Appointment will be the parameter for the [[#Operations2|$book operation]].
The operation can be performed by an HTTP POST as shown:

<code>POST [base]/Appointment/$book</code>

The full specification of the $book operation is described here:
[[#Operations2|$book operation]]

The proposed Appointment has to be put in the request body using the Parameters resource.

<pre>
{
"resourceType": "Parameters",
"parameter": [
{
"name": "appointment",
"resource": {
"resourceType": "Appointment",
--snip--
}
},
]
}
</pre>

A Bundle containing an required Appointment resource with status "booked" or "cancelled" and an optional [http://hl7.org/fhir/stu3/operationoutcome OperationOutcome] resource can be expected as return.

===Server - XIS===
Important sections of the FHIR specification for a server in this use case are the [http://hl7.org/fhir/STU3/http.html#2.21.0 RESTful API section] and the [http://hl7.org/fhir/STU3/operations.html operations section].

====Serve available slots ====
A Client can fetch available slots using the $find operation. (See client section above for details). A server is expected to answer this operation with a Bundle containing the available Slots based on the clients' input parameters, and/or an optional OperationOutcome resource.

====Handle appointment booking request ====
A Client can propose an appointment to be booked using the <code>$book</code> operation. (See client section above for details). A server is expected to answer this operation with a Bundle containing the proposed appointment with either a "booked" or "cancelled" status based on the XIS internal logic. The server can also send an optional OperationOutcome resource, containing a "success" or "error" explaining the result.

====Response on operation request====
If an operation succeeds, an HTTP Status success code is returned. This will usually be a 2xx code, though it may also be a 303 See Other. Other kinds of 3xx codes should be understood to indicate that the operation did not proceed, and the client will need to re-issue the operation if it can perform the redirection (e.g. may get redirected to an authentication step). User agents should note that servers may issue redirects, etc. to authenticate the client in response to an operation request. An HTTP status code of 4xx or 5xx indicates an error, and an OperationOutcome SHOULD be returned with details.

In general, an operation response uses the [http://hl7.org/fhir/parameters.html Parameters] format regardless of whether there is only one or there are multiple named out parameters.
However, the defined <code>$find</code> operation only has one out parameters named "return". This means the parameters resource doesn't have to be used and the response is simply the resource itself. Which in this case is a [http://hl7.org/fhir/bundle.html Bundle] resource of type "search-response", containing the requested resources.

The resources that are returned by the operation may be retained and made available in the resource repository on the operation server. In that case, the server will provide the identity of the resource in the returned resources. When resources that are not persisted are returned in the response, they will have no id property.

Link to the relevant FHIR specification: http://hl7.org/fhir/stu3/operations.html

==Interactions, operations, search parameters==
===Interactions===
The following FHIR interactions are needed to retrieve avaialable slots information:
* [http://hl7.org/fhir/STU3/http.html#operations Operations]

===Operations===
* '''$find''' (Fetch available Slots): [https://simplifier.net/NictizSTU3-zib2017/eafspraken-slot-find http://nictiz.nl/fhir/OperationDefinition/eAfspraak-slot-prefetch]

<html>
<iframe width="100%" height="500" src=https://www.simplifier.net/embed/render?id=NictizSTU3-ZIB2017/eafspraken-slot-find frameborder="1" align="middle"></iframe></html>

* '''$book''' (Book Appointment): [https://simplifier.net/NictizSTU3-ZIB2017/eafspraken-appointment-book http://nictiz.nl/fhir/OperationDefinition/eAfspraak-appointment-book]

<html>
<iframe width="100%" height="500" src=https://www.simplifier.net/embed/render?id=NictizSTU3-ZIB2017/eafspraken-appointment-book frameborder="1" align="middle"></iframe></html>

==Profiles==
{| class="wikitable" width="1400px"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|Name NL||Name EN||FHIR Resource||URL profile
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Patient
| #ZIB Patient|Patient
| Patient
| [https://simplifier.net/NictizSTU3-zib2017/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
|-
| Zorgverlener
| HealthProfessional
| Practitioner
| [https://simplifier.net/NictizSTU3-zib2017/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
|-
| Zorgaanbieder
| HealthcareProvider
| Organization
| [https://simplifier.net/NictizSTU3-zib2017/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
|-
| Afspraak
| Appointment
| Appointment
| [https://simplifier.net/nictizstu3-zib2017/eafspraken-appointment http://nictiz.nl/fhir/StructureDefinition/eAfspraak-Appointment]
|-
|-
| Slot
| Slot
| Slot
| [https://simplifier.net/nictizstu3-zib2017/eafsprakenslot http://nictiz.nl/fhir/StructureDefinition/eAfspraak-Slot]
|-
|}

==Examples==

=Use case: cancel/reschedule an appointment=

==Introduction==
The goal of this use case is to allow patients to cancel a specific appointment. Below is described how a PHR can send a cancellation request and how a XIS should handle this.

'''Rescheduling is a combination of cancelling and re-booking an appointment. For booking an appointment, see the use case above.'''

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Cancel appointment
|-
|style="background-color: white;vertical-align:top;"|Healthcare professional (using a XIS)
|style="background-color: white;vertical-align:top;"|Handles cancellation request
|}

==Invocations==
===Client - PHR===

====Search for available slots ====
The PHR system can request the cancellation of a specific appointment using the [[#Operations3|$cancel operation]] with the appointment as input parameter on the Appointment endpoint. This operation is a request for the XIS to handle the request, and provide a Bundle resource with the Appointment resource (canceled or not) and an optional OperationOutcome slots as return. The operation can be performed by an HTTP POST as shown:

<code>POST [base]/Appointment/$cancel</code>

The optional input parameters can be put in the request body using the Parameters resource. The full specification of the $cancel operation is described here:
[[#Operations3|$prefetch operation]]

'''example body'''

<pre>
{
"resourceType": "Parameters",
"parameter": [
{
"name": "appointment",
"resource": {
"resourceType": "Appointment",
--snip--
}
},
]
}
</pre>

A Bundle containing the Appointment resources and an optional [http://hl7.org/fhir/stu3/operationoutcome.html OperationOutcome] resource can be expected as return.
If the appointment was indeed cancelled, the returned Appointment resource will have a status of "cancelled". If not, the Appointment will be returned as is, and a explanation will be returned in an OperationOutcome resource, with an explanation.

For more information on how operations work using FHIR see [http://hl7.org/fhir/stu3/operations.html the FHIR search specification]

===Server - XIS===
Important sections of the FHIR specification for a server in this use case are the [http://hl7.org/fhir/STU3/http.html#2.21.0 RESTful API section] and the [http://hl7.org/fhir/STU3/operations.html operations section].

====Handle appointment cancellation request ====
A Client can propose an appointment to be booked using the $cancel operation. (See client section above for details). A server is expected to answer this operation with a Bundle containing the proposed appointment either unchanged (if the request was denied) or with a "cancelled" status (if the request was approved) based on the XIS's internal logic. The server can also send an optional OperationOutcome resource, containing a "success" or "error" explaining the result.

====Response on operation request====
If an operation succeeds, a HTTP Status success code is returned. This will usually be a 2xx code, though it may also be a 303 See Other. Other kinds of 3xx codes should be understood to indicate that the operation did not proceed, and the client will need to re-issue the operation if it can perform the redirection (e.g. may get redirected to an authentication step). User agents should note that servers may issue redirects, etc. to authenticate the client in response to an operation request. An HTTP status code of 4xx or 5xx indicates an error, and an OperationOutcome SHOULD be returned with details.

In general, an operation response uses the [http://hl7.org/fhir/parameters.html Parameters] format whether there is only one or there are multiple named out parameters.
However, the defined <code>$cancel</code> operation only has one out parameters named "return". This means the parameters don't have to be used and the response is simply the resource itself. Which in this case is a [http://hl7.org/fhir/bundle.html Bundle] resource of type "search-response", containing the requested resources.

The resources that are returned by the operation may be retained and made available in the resource repository on the operation server. In that case, the server will provide the identity of the resource in the returned resources. When resources that are not persisted are returned in the response, they will have no id property.

Link to the relevant FHIR specification: http://hl7.org/fhir/stu3/operations.html

==Interactions, operations, search parameters==
===Interactions===
The following FHIR interactions are needed to retrieve avaialable slots information:
* [http://hl7.org/fhir/STU3/http.html#operations Operations]

===Operations===
* '''$cancel''' (Cancel Appointment): [https://simplifier.net/NictizSTU3-zib2017/eAfspraken-appointment-cancel http://nictiz.nl/fhir/OperationDefinition/eAfspraak-appointment-cancel]

<html>
<iframe width="100%" height="500" src=https://simplifier.net/embed/render?id=NictizSTU3-ZIB2017/eafspraken-appointment-cancel frameborder="1" align="middle"></iframe></html>

==Profiles==
{| class="wikitable" width="1400px"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|Name NL||Name EN||FHIR Resource||URL profile
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Afspraak
| Appointment
| Appointment
| [https://simplifier.net/nictizstu3-zib2017/eAfspraken-Appointment http://nictiz.nl/fhir/StructureDefinition/eAfspraak-Appointment]
|-
|}

==Examples==
[[categorie:MedMij FHIR Use Cases]]

MedMij:V2018.04 FHIR IG

2018-08-30T12:55:07Z

Marten Smits:

{{#customtitle:MedMij FHIR Implementation Guide}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 03 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.04_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.04_FHIR_IG|Technisch]]
desc none
</imagemap>
__TOC__

{{large|Quick links}}
----
{|
! [[Bestand:BGZ_icoon.png |link=MedMij:V2018.04_FHIR_BGZ_2017 |100px|Patient Summary (BgZ)]]
!   
! [[Bestand:Medication_Icoon.png |link=MedMij:V2018.04_FHIR_MedicationProcess|100px |Medication Process]]
!   
! [[Bestand:AllergyIntolerance.png |link=MedMij:V2018.04_FHIR_AllergyIntolerance|106px |Allergy Intolerance]]
!   
! [[Bestand:Self-measurements_Icoon.png |link=MedMij:V2018.04_FHIR_VitalSigns|105px |Self-Measurements]]
!   
! [[Bestand:LabResults@2x.png |link=MedMij:V2018.04_FHIR_LaboratoryResults |100px|Laboratory Results]]
!   
! [[Bestand:PDF-A icoon.png|link=MedMij:V2018.04_FHIR_PDFA |100px |PDF/A - Health Documents]]
!   
! [[Bestand:EAfspraak_-_text.png |link=MedMij:V2018.04_FHIR_eAfspraak |98px |eAfspraak - Appointments]]
!   
! [[Bestand:Huisartsgegevens-met-tekst.png|link=MedMij:V2018.04_FHIR_GP_Data |105px |Huisartsgegevens - GP Data]]
|}

=About the IG=
This is the technical MedMij FHIR implementation guide based on '''HL7® FHIR® version STU3'''.

==Purpose==
An implementation guide for making use of FHIR in the Dutch context. This guide is developed specifically for the use of HL7® FHIR® between personal health records(PHR) and healthcare provider systems (XIS). PHR and XIS vendors that participate in MedMij conform to a framework of agreements, in Dutch this is called the 'afsprakenstelsel.' HL7 FHIR, or just 'FHIR', plays an important role among those agreements and is used as a standard to exchange health information between the involved parties. The purpose of this guide is to describe use cases and provide technical guidance on how to implement FHIR in these situations. This guide outlines the FHIR building blocks, or profiles, involved in these use cases. Moreover, this guide provides a textual explanation of these building blocks and describes their relationship and boundaries.

==Scope==
The scope of this guide includes requirements to enable PHR and XIS in the Dutch realm to use standardized structured data in a defined inter-organizational transaction. Health is a vast domain. Therefore, MedMij has made scoping choices for its roadmap. MedMij starts with a limited number of medical subdomains but has the vision to elaborate on more domains later. In scope domains are first described in the [[MedMij:V2018.04_Ontwerpen|functional design]] that underlies this technical design.

==Background==
MedMij aims to stimulate electronic information exchange between patients and caregivers. Caregivers generally have access to software applications to help them support their work in treating patients. Software applications for patients are evolving as we speak, but patients typically are not yet enabled to be regarded as a true partner in the care process. MedMij delivers an agreements scheme to enable patients to become that true partner. The section [[#Afsprakenstelsel]] describes the relation to this implementation guide.

Information standards have a functional and technical component. The functional part contains definitions of relevant concepts (dataset) and scenario’s that define when to exchange which of those concepts. The technical part translates the functional scenario’s in an exchange format (such as HL7v3 or FHIR). The stakeholders in MedMij have chosen to introduce FHIR as a modern standard to exchange information in MedMij. A dutch factsheet that explains why FHIR is chosen is available on the [https://www.medmij.nl/wp-content/uploads/2017/06/Factsheet-MedMij-FHIR.pdf MedMij website]. MedMij delivers a FHIR representation ([http://hl7.org/fhir/STU3/profiling.html profiles]) for each domain in scope.

The program ‘Registratie aan de bron’ (Data capture at the point of Care) has defined [https://zibs.nl/wiki/HCIM_Mainpage| Health and Care Information models] (zorginformatiebouwstenen or ZIB's) for The Netherlands. ZIB's contain definitions of healthcare concepts. MedMij information standards contain mappings to these ZIB's. MedMij creates FHIR profiles based on ZIB's which include mappings to the relevant ZIB concepts. As a result, the created profiles enable context-free implementation. Therefore, these profiles are applicable in a broader context than the described use cases or the MedMij context. Reuse of these profiles enables interoperability for health information.

==Audience==
The main target audience of this implementation guide is software vendors and developers that will implement FHIR as part of electronic information exchange under MedMij. This IG is intended for developers of PHR as well as XIS vendors.
Users of this guide are expected to be familiar with the [http://hl7.org/fhir/stu3 FHIR specification] and resource processing. This guide provides links to relevant sections of the FHIR specification. This implementation guide is not intended to be a tutorial on that subject.

==Language==
This implementation guide is written in English, even though the majority of the documentation in MedMij is in Dutch. A Dutch translation of this document may become available. However, the English version is and remains leading. The rationale for choosing English is as follows. Implementers in healthcare are in many cases foreign, e.g., through outsourcing or because the company is a multinational. But even if they are Dutch native speakers, the educational tracks, their programming language of choice, and the implementer communities they are part of will largely be based on the English language. In creating the documentation for the target audience, we have received overwhelming preference from the MedMij implementer community for English. English documentation saves them investments and risks in getting a translation agency on a per vendor basis for each version of the documentation, while at the same time not alienating the native Dutch speaking audience. As a side effect it also helps Nictiz in the international realm in discussions with relevant initiatives such as Argonaut (US), Patients Know Best (UK), the Finnish PHR, and the HL7/FHIR community at large.

=Afsprakenstelsel=
[[Bestand:Afsprakenstelsel-01.png|link=https://www.medmij.nl/afsprakenstelsel/|rechts |100px|Go to Afsprakenstelsel]]
The 'afsprakenstelsel' references the MedMij information standards. In addition, the MedMij information standards are specified in the context of the 'afsprakenstelsel.' This applies to the implementation guidance of the use cases described in this implementation guide.

For example, all use cases performed in the context of a specific authenticated patient, for which an OAuth2 token has been retrieved using the Authentication mechanisms described in the [https://www.medmij.nl/afsprakenstelsel/ 'afsprakenstelsel']. This token must be passed in each call in the HTTP header named “Authorization”. Each XIS Gateway is required to perform filtering based on the patient associated with the OAuth2 token received for the request so that only the records associated with the authenticated patient are returned.

=Functional design=
[[Bestand:Functioneel-02.png|link=MedMij:V2018.04_Ontwerpen |100px|rechts|Functional design|Go to functional design]]

All use cases described in this implementation guide have a functional counterpart. The functional design pages are written in Dutch. The main overarching wiki page of the functional designs can be found at [[MedMij:V2018.04_Ontwerpen|here]]. From this page, you can link to the specific use case through the patient journey image or the table index. It is possible to link to the specific functional design page from the technical use case pages in this wiki by clicking on the functional circle in the top image.

=Use cases=
Implementation guidance is provided per use case on separate wiki pages. The next section provides implemenation guidance that apply for all use cases. The green circles represent the available use cases. Click on the circle to go to the use case page.

{|
! [[Bestand:BGZ_icoon.png |link=MedMij:V2018.04_FHIR_BGZ_2017 |100px|Patient Summary (BgZ)]]
!   
! [[Bestand:Medication_Icoon.png |link=MedMij:V2018.04_FHIR_MedicationProcess|100px |Medication Process]]
!   
! [[Bestand:AllergyIntolerance.png |link=MedMij:V2018.04_FHIR_AllergyIntolerance|106px |Allergy Intolerance]]
!   
! [[Bestand:Self-measurements_Icoon.png |link=MedMij:V2018.04_FHIR_VitalSigns|105px |Self-Measurements]]
!   
! [[Bestand:LabResults@2x.png |link=MedMij:V2018.04_FHIR_LaboratoryResults |100px|Laboratory Results]]
!   
! [[Bestand:PDF-A icoon.png|link=MedMij:V2018.04_FHIR_PDFA |100px |PDF/A - Health Documents]]
!   
! [[Bestand:EAfspraak_-_text.png |link=MedMij:V2018.04_FHIR_eAfspraak |98px |eAfspraak - Appointments]]
!   
! [[Bestand:Huisartsgegevens-met-tekst.png|link=MedMij:V2018.04_FHIR_GP_Data |105px |Huisartsgegevens - GP Data]]
|}

=Use case overarching principles=
==Retrieve information: what's new==
Retrieving information that was added, changed, deleted relative to a date may be done using the search parameter <code>_lastUpdated</code> available for any resource. Using the parameter <code>_lastUpdated</code> a system may query for data that is ''new'' since the previous query. Any FHIR server is expected to support this parameter <code>_lastUpdated</code>.

The search parameter _lastUpdated can be used to select resources based on the last time they were changed:

GET [base]/Observation?_lastUpdated=gt2018-10-01

This search finds any observations changed since Oct 1, 2018. More information may be found in the section _lastUpdated in the FHIR specification: http://hl7.org/fhir/STU3/search.html#lastUpdated.

An example search request is shown below.

<pre>GET [base]/Consent?category=http://snomed.info/sct|11291000146105&_lastUpdated=gt2018-10-01</pre>

This search finds all Consent resources with a category SNOMED code 11291000146105 that have been changed since Oct 1, 2018.

=Relevant links=
'''HL7 FHIR specification'''
* [http://hl7.org/fhir/STU3/index.html HL7 FHIR STU3]
* [http://wiki.hl7.org/index.php?title=FHIR FHIR wiki]

'''Repository of MedMij FHIR artefacts'''
* [https://simplifier.net/NictizSTU3-Zib2017 Simplifier.net]
** [https://github.com/Nictiz/Nictiz-STU3-Zib2017 GitHub] (similar as Simplifier.net)

'''Test Tools'''
* MedMij FHIR server - https://vonk.test-nictiz.nl
* Windows desktop validator using .NET HL7 FHIR Profile Validation API - [https://github.com/ewoutkramer/Furore.Fhir.ValidationDemo link to download]

=Contact=

'''MedMij'''

W: http://www.medmij.nl

E: standaarden@medmij.nl

'''Nictiz'''

W: https://www.nictiz.nl

T: [tel:+31703173450 +31-70 317 3450]

'''Feedback on content in open consultation'''
* [https://www.medmij.nl/consultatiedocumenten/ Documentation]
* [https://bits.nictiz.nl/secure/BrowseProjects.jspa#all BITS for issues]

'''FHIR Questions and Discussions'''

* [http://chat.fhir.org chat.fhir.org]

=Release Notes=

{| class="wikitable"
! Version !! Date !! Notes
|-
| [[MedMij:V2018.02_FHIR_IG|2018.02]] || 2018-03-29 || Added BgZ 2017
|-
| [[MedMij:V2018.01_FHIR_IG|2018.01]] || 2018-02-21 || Added GP patient data
|-
| [[MedMij:V2017.04_FHIR_IG|2017.04]] || 2017-12-18 || Added Appointments, Medication, Laboratory results, AllergyIntolerance, Self-measurements
|-
| [[MedMij:V2017.03_FHIR_IG|2017.03]] || 2017-11-07 || Added PDF/A.
|-
| [[MedMij:V2017.02_Ontwerpen|2017.02]] || 2017-10-11 || Unchanged. No wiki pages created for FHIR.
|-
| [[MedMij:V2017.01_FHIR_IG|2017.01]] || 2017-10-02 || Initial version containing Patient Administration Resources, Patient Summary (BgZ),
|}

MedMij:V2018.03 FHIR IG

2018-08-06T11:47:15Z

Marten Smits:

{{#customtitle:MedMij FHIR Implementation Guide}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 03 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.03_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.03_FHIR_IG|Technisch]]
desc none
</imagemap>
__TOC__

{{large|Quick links}}
----
{|
! [[Bestand:BGZ_icoon.png |link=MedMij:V2018.03_FHIR_BGZ_2017 |100px|Patient Summary (BgZ)]]
!   
! [[Bestand:Medication_Icoon.png |link=MedMij:V2018.03_FHIR_MedicationProcess|100px |Medication Process]]
!   
! [[Bestand:AllergyIntolerance.png |link=MedMij:V2018.03_FHIR_AllergyIntolerance|106px |Allergy Intolerance]]
!   
! [[Bestand:Self-measurements_Icoon.png |link=MedMij:V2018.03_FHIR_VitalSigns|105px |Self-Measurements]]
!   
! [[Bestand:LabResults@2x.png |link=MedMij:V2018.03_FHIR_LaboratoryResults |100px|Laboratory Results]]
!   
! [[Bestand:PDF-A icoon.png|link=MedMij:V2018.03_FHIR_PDFA |100px |PDF/A - Health Documents]]
!   
! [[Bestand:EAfspraak_-_text.png |link=MedMij:V2018.03_FHIR_eAfspraak |98px |eAfspraak - Appointments]]
!   
! [[Bestand:Huisartsgegevens-met-tekst.png|link=MedMij:V2018.03_FHIR_GP_Data |105px |Huisartsgegevens - GP Data]]
|}

=About the IG=
This is the technical MedMij FHIR implementation guide based on '''HL7® FHIR® version STU3'''.

==Purpose==
An implementation guide for making use of FHIR in the Dutch context. This guide is developed specifically for use of HL7® FHIR® between personal health records(PHR) and healthcare provider systems (XIS). PHR and XIS vendors that participate in MedMij conform to a framework of agreements, in Dutch this is called the 'afsprakenstelsel'. HL7 FHIR, or just 'FHIR', plays an important role among those agreements and is used as a standard to exchange health information between the involved parties. The purpose of this guide is to describe use cases and provide technical guidance on how FHIR should be implemented in these situations. The FHIR building blocks, or profiles, involved in these use cases are outlined in this guide. Moreover, this guide provides textual explanation of these building blocks and describes their relationship and boundaries.

==Scope==
The scope of this guide includes requirements to enable PHR and XIS in the Dutch realm to use standardized structured data in a defined inter-organizational transaction. Health is a very broad domain. Therefore, MedMij has made scoping choices for its roadmap. MedMij starts with a limited number of medical subdomains but has the vision to elaborate on more domains later. In scope domains are first described in the [[MedMij:V2018.03_Ontwerpen|functional design]] that underlies this technical design.

==Background==
MedMij aims to stimulate electronic information exchange between patients and caregivers. Caregivers generally have access to software applications to help them support their work in treating patients. Software applications for patients are evolving as we speak, but patients typically are not yet enabled to be regarded as a true partner in the care process. MedMij delivers an agreements scheme, in order to enable patients to become that true partner. The section [[#Afsprakenstelsel]] describes the relation to this implementation guide.

Information standards have a functional and technical component. The functional part contains definitions of appropriate concepts (dataset) and scenario’s that define when to exchange which of those concepts. The technical part translates the functional scenario’s in an exchange format (such as HL7v3 or FHIR). The stakeholders in MedMij have chosen to introduce FHIR as a modern standard to exchange information in MedMij. A dutch factsheet, that explains why FHIR is chosen is available on the [https://www.medmij.nl/wp-content/uploads/2017/06/Factsheet-MedMij-FHIR.pdf MedMij website]. MedMij delivers a FHIR representation ([http://hl7.org/fhir/STU3/profiling.html profiles]) for each domain in scope.

The program ‘Registratie aan de bron’ (Data capture at the point of Care) has defined [https://zibs.nl/wiki/HCIM_Mainpage| Health and Care Information models] (zorginformatiebouwstenen or ZIB's) for The Netherlands. ZIB's contain definitions of healthcare concepts. MedMij information standards are mapped to these ZIB's. MedMij creates FHIR profiles based on ZIB's which include mappings to the relevant ZIB concepts. As a result, the created profiles enable context-free implementation. To clarify, these created profiles can be used in a broader context than the described use cases or the MedMij context. This enables interoperability for health information.

==Audience==
The main target audience of this implementation guide are software vendors and developers that will implement FHIR as part of electronic information exchange under MedMij. This IG is intended for developers of PHR as well as XIS vendors.
Users of this guide are expected to be familiar with the [http://hl7.org/fhir/stu3 FHIR specification] and resource processing. Links to relevant sections of the FHIR specification will be provided. This implementation guide is not intended to be a tutorial on that subject.

==Language==
This implementation guide is written in English, even though the majority of the documentation in MedMij is in Dutch. A Dutch translation of this document may become available, however, the English version is and remains leading. The rationale for choosing English is as follows. Implementers in healthcare are in many cases foreign, e.g. through outsourcing or because the company is a multinational. But even if they are Dutch native speakers, the educational tracks, their programming language of choice, and the implementer communities they are part of will largely be based on the English language. In creating the documentation for this target audience we have received overwhelming preference from the MedMij implementer community for English. This saves them investments and risks in getting a translation agency on a per vendor basis for each version of the documentation, while at the same time not alienating the native Dutch speaking audience. As a side effect it also helps Nictiz in the international realm in discussions with relevant initiatives such as Argonaut (US), Patients Know Best (UK), the Finnish PHR, and the HL7/FHIR community at large.

=Afsprakenstelsel=
[[Bestand:Afsprakenstelsel-01.png|link=https://www.medmij.nl/afsprakenstelsel/|rechts |100px|Go to Afsprakenstelsel]]
The MedMij information standards are referenced from the 'afsprakenstelsel'. The use of these MedMij information standards should be seen in the context of the 'afsprakenstelsel'. This is applicable to the implementation guidance of the use cases described in this implementation guide.

For example, all use cases performed in the context of a specific authenticated patient, for which an OAuth2 token has been retrieved using the Authentication mechanisms described in the [https://www.medmij.nl/afsprakenstelsel/ 'afsprakenstelsel']. This token must be passed in each call in the HTTP header named “Authorization”. Each XIS Gateway is required to perform filtering based on the patient associated with the OAuth2 token received for the request so that only the records associated with the authenticated patient are returned.

=Functional design=
[[Bestand:Functioneel-02.png|link=MedMij:V2018.03_Ontwerpen |100px|rechts|Functional design|Go to functional design]]

All use cases described in this implementation guide have a functional counterpart. The functional design pages are written in Dutch. The main overarching wiki page of the functional designs can be found [[MedMij:V2018.03_Ontwerpen|here]]. From this page, you can link to the specific use case through the patient journey image or the table index. It is also possible to link to the specific functional design page from the technical use case pages in this wiki by clicking on the functional circle in the top image.

=Use Cases=
Implementation guidance is provided per use case on separate wiki pages. The following green circles represent the available use cases. Click on the circle to go to the use case page.

{|
! [[Bestand:BGZ_icoon.png |link=MedMij:V2018.03_FHIR_BGZ_2017 |100px|Patient Summary (BgZ)]]
!   
! [[Bestand:Medication_Icoon.png |link=MedMij:V2018.03_FHIR_MedicationProcess|100px |Medication Process]]
!   
! [[Bestand:AllergyIntolerance.png |link=MedMij:V2018.03_FHIR_AllergyIntolerance|106px |Allergy Intolerance]]
!   
! [[Bestand:Self-measurements_Icoon.png |link=MedMij:V2018.03_FHIR_VitalSigns|105px |Self-Measurements]]
!   
! [[Bestand:LabResults@2x.png |link=MedMij:V2018.03_FHIR_LaboratoryResults |100px|Laboratory Results]]
!   
! [[Bestand:PDF-A icoon.png|link=MedMij:V2018.03_FHIR_PDFA |100px |PDF/A - Health Documents]]
!   
! [[Bestand:EAfspraak_-_text.png |link=MedMij:V2018.03_FHIR_eAfspraak |98px |eAfspraak - Appointments]]
!   
! [[Bestand:Huisartsgegevens-met-tekst.png|link=MedMij:V2018.03_FHIR_GP_Data |105px |Huisartsgegevens - GP Data]]
|}

=Relevant links=
'''HL7 FHIR specification'''
* [http://hl7.org/fhir/STU3/index.html HL7 FHIR STU3]
* [http://wiki.hl7.org/index.php?title=FHIR FHIR wiki]

'''Repository of MedMij FHIR artefacts'''
* [https://simplifier.net/NictizSTU3-Zib2017 Simplifier.net]
** [https://github.com/Nictiz/Nictiz-STU3-Zib2017 GitHub] (similar as Simplifier.net)

'''Test Tools'''
* MedMij FHIR server - https://vonk.test-nictiz.nl
* Windows desktop validator using .NET HL7 FHIR Profile Validation API - [https://github.com/ewoutkramer/Furore.Fhir.ValidationDemo link to download]

=Contact=

'''MedMij'''

W: http://www.medmij.nl

E: standaarden@medmij.nl

'''Nictiz'''

W: https://www.nictiz.nl

T: [tel:+31703173450 +31-70 317 3450]

'''Feedback on content in open consultation'''
* [https://www.medmij.nl/consultatiedocumenten/ Documentation]
* [https://bits.nictiz.nl/secure/BrowseProjects.jspa#all BITS for issues]

'''FHIR Questions and Discussions'''

* [http://chat.fhir.org chat.fhir.org]

=Release Notes=

{| class="wikitable"
! Version !! Date !! Notes
|-
| [[MedMij:V2018.03_FHIR_IG|2018.03]] || 2018-03-29 || Added BgZ 2017 and GP patient data publication.
|-
| [[MedMij:V2018.02_FHIR_IG|2018.02]] || 2018-03-29 || Added BgZ 2017 for public consultation.
|-
| [[MedMij:V2018.01_FHIR_IG|2018.01]] || 2018-02-21 || Added GP patient data for public consultation.
|-
| [[MedMij:V2017.04_FHIR_IG|2017.04]] || 2017-12-18 || Added Appointments, Medication, Laboratory results, AllergyIntolerance, Self-measurements.
|-
| [[MedMij:V2017.03_FHIR_IG|2017.03]] || 2017-11-07 || Added PDF/A.
|-
| [[MedMij:V2017.02_Ontwerpen|2017.02]] || 2017-10-11 || Unchanged. No wiki pages created for FHIR.
|-
| [[MedMij:V2017.01_FHIR_IG|2017.01]] || 2017-10-02 || Initial version containing Patient Administration Resources, Patient Summary (BgZ),
|}

MedMij:V2018.03 FHIR AllergyIntolerance

2018-08-06T11:35:36Z

Marten Smits:

{{#customtitle:MedMij FHIR use case AllergyIntolerance}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:Allergie.png|link=|87px |links||AllergyIntolerance]]
<imagemap>Bestand:Leeswijzer-technisch-banner 03 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.03_OntwerpAllergieIntolerantie|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.03_FHIR_IG|Technisch]]
desc none
</imagemap>

__TOC__

=Introduction=
[[Bestand:Functioneel-02.png|link=MedMij:V2018.03_Ontwerpen |100px|rechts|Functional design|Go to functional design]]

This page describes a patient's use case, in a personal health record (PHR) context, in relation to the information standard [https://informatiestandaarden.nictiz.nl/wiki/Landingspagina_Medicatieproces Medication Process] for allergy and intolerance information. This use case is based on version 6.12.X of this standard. Functional specification of this use case is described in the [[MedMij:V2018.03_Ontwerpen| functional design wiki page]]. The technical specification is described here. HL7 FHIR STU3 is used for this purpose.

=Actors involved=
{| class="wikitable"
! colspan="2" style="text-align:left;" | Persons
! colspan="2" style="text-align:left;" | Systems
! colspan="2" style="text-align:left;" | FHIR Capability Statements
|-
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
|-
| Patient
| The user of a personal healthcare enviorment.
| PHR
| Personal health record
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/NictizSTU3/allergyintolerance-clientcapabilities CapabilityStatement: Client]
| AllergyIntolerance client requirements
|-
| Healthcare professional
| The user of a XIS
| XIS
| Healthcare information system
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/NictizSTU3/allergyintolerance-servercapabilities CapabilityStatement: Server]
| AllergyIntolerance server requirements
|}

=Use case: Retrieve AllergyIntolerance information=
{{FHIR-IG-Afsprakenstelsel-Note}}

==Introduction==
The retrieve AllergyIntolerance transaction is used by the PHR to retrieve allergy and intolerance information from the XIS.

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transaction group'''
! style="text-align:left;"| '''Transaction'''
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;" rowspan="3"|Retrieve AllergyIntolerance(PULL)
|style="background-color: white;vertical-align:top;"|Retrieve AllergyIntolerance request
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Request allergy and intolerance information from the XIS
|-
|style="background-color: white;vertical-align:top;"|Retrieve AllergyIntolerance response
|style="background-color: white;vertical-align:top;"|Healthcare professional (using a XIS)
|style="background-color: white;vertical-align:top;"|Serves allergy and intolerance information to the PHR
|}

==Invocations==
===PHR: request message===
The request message represents an HTTP GET parameterized query from the PHR to the XIS.

====Trigger Events====
When the patient(PHR) wants to obtain allergy and intolerance information, it issues a retrieve AllergyIntolerance request message.

====Message Semantics====
The PHR executes an HTTP GET conform to the FHIR [http://hl7.org/fhir/http.html RESTfull] and [http://hl7.org/fhir/search.html search] specification against the XIS's AllergyIntolerance endpoint. This search query URL is configurable by the PHR and has the following format.

<pre>
GET [base]/AllergyIntolerance?[parameters]{&_format=[mime-type]}
</pre>

=====Search Parameters=====
The PHR may supply, and the XIS shall be capable of processing, all query parameters listed below. These search parameters are a selection of the defined search parameters by the HL7 FHIR specification search parameters of [http://hl7.org/fhir/STU3/allergyintolerance.html#search AllergyIntolerance].

{| class="wikitable"
! colspan="3" style="font-weight: bold; text-align:left;" | AllergyIntolerance
|-
| style="font-weight: bold;" | Name
| style="font-weight: bold;" | Type
| style="font-weight: bold;" | Description
|-
| onset
| date
| Date(/time) when manifestations showed
|}

=====Example search URLs=====

<pre>
1. GET https://vonk.test-nictiz.nl/AllergyIntolerance
2. GET https://vonk.test-nictiz.nl/AllergyIntolerance?onset=ge2010-01-01&onset=le2011-12-31 </pre>

# Retrieves all AllergyIntolerance resources.
# Retrieves all AllergyIntolerance resources that have an onset date(/time) within a 2 year period.

=====Expected Actions=====
The XIS shall process the query to discover AllergyIntolerance resources that match the search parameters given.

===XIS: response message===
The XIS returns an HTTP Status code appropriate to the processing as well as a FHIR Bundle including the allergy and intolerance medication information.

====Trigger Events====
The XIS completed processing of the Retrieve AllergyIntolerance request message.

====Message Semantics====
Based on the query results, the XIS will either return an error or success. When the XIS needs to report an error, it SHALL use HTTP error response codes and SHOULD include a FHIR OperationOutcome resource with more details on the failure. If the request message is processed successfully, whether or not any AllergyIntolerance resources are found, the HTTP status code SHALL be 200.

The response message shall be a Bundle resource of type "searchset" containing zero or more FHIR resources as entries. If the XIS is sending warnings, the Bundle resource SHALL also contain a FHIR OperationOutcome resource that contains those warnings. The FHIR specification describes the relevant sections:
*[http://hl7.org/fhir/STU3/http.html RESTful API framework]
*[http://hl7.org/fhir/STU3/search.html#errors Search errors]
*[http://hl7.org/fhir/STU3/bundle.html Bundle resource]
*[http://hl7.org/fhir/operationoutcome.html OperationOutcome resource]

=====Message resource content=====
The returned data to the PHR should conform to the ZIB AllergyIntolerance profile. The table below shows the relevant ZIBs and their profiles. The resources in the response message SHALL be a valid instance of these profiles. All resources SHALL include their related profile canonical URL in the ''meta.profile'' element in order to show compliance.

{| class="wikitable"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|ZIB name NL||ZIB name EN||FHIR Resource||URL profile||Reference to section
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Patient
| #ZIB Patient|Patient
| Patient
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_Patient | Patient]]
|-
| Zorgverlener
| HealthProfessional
| Practitioner
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_HealthProfessional | HealthProfessional]]
|-
| AllergieIntolerantie
| AllergyIntolerance
| AllergyIntolerance
| [https://simplifier.net/NictizSTU3-Zib2017/zib-AllergyIntolerance http://nictiz.nl/fhir/StructureDefinition/zib-AllergyIntolerance]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_AllergyIntolerance| AllergyIntolerance]]
|}

====Expected Actions====
The PHR processes the results according to application-defined rules. The PHR should be robust as the response may contain medication information resources as mentioned in the former section.

==Interactions, operations, search parameters==
===Interactions===
The following logical interactions are needed for the retrieve medication information transaction:
* [http://hl7.org/fhir/STU3/http.html#search Search]

===Operations===
No operations are defined or needed for this transaction.

===Search parameters===
The following search parameter types and search result parameters need to be supported for this transaction.

Search parameter types:
* [http://hl7.org/fhir/STU3/search.html#date date]

[[categorie:MedMij FHIR Use Cases]]

MedMij:V2018.03 FHIR BGZ 2017

2018-06-06T12:48:42Z

Marten Smits:

{{#customtitle:MedMij FHIR use case BgZ 2017}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:BGZ_icoon.png |link=|links|90px|Use case BgZ 2017|Patient Summary (BgZ)]]
<imagemap>Bestand:Leeswijzer-technisch-banner 03 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.03_OntwerpBGZ_2017|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.03_FHIR_IG|Technisch]]
desc none
</imagemap>

__TOC__

==Introduction==
[[Bestand:Functioneel-02.png|link=MedMij:V2018.03_Ontwerpen |100px|rechts|Functional design|Go to functional design]]

The program ‘Registratie aan de bron’ (Data capture at the point of Care) has defined Health and Care Information models ([https://zibs.nl/wiki/HCIM_Mainpage HCIMs] (English) or [https://zibs.nl/wiki/ZIB_Hoofdpagina ZIBs] (Dutch)) for The Netherlands. Next to these HCIMs, the program ‘Registratie aan de bron’ also made a selection of these HCIMs into the so-called ‘Basisgegevensset Zorg’ (Common Clinical Dataset, a Dutch version of a ‘patient summary’, further referred to as ‘BgZ’). The BgZ serves as a minimal healthcare dataset that is always appropriate for caregivers in order to provide continuity of care for a patient and can be seen as a representation of a patient summary.

A subselection of the published [https://zibs.nl/wiki/HCIM_Release_2017(EN) HCIMs release 2017] constitute the [https://www.registratieaandebron.nl/pdf/BgZ_specificatie_obv_zibs_2017_v1.0.pdf BgZ 2017]. The BgZ makes a subselection of the information concepts within the HCIMs or restricts the HCIMs to a certain category. For example, only include the general practitioner of the patient or only the last known value of 'X'. MedMij created FHIR profiles that represent these HCIMs completely if no existing and usable profiles were available. The profiles represent their entire respective HCIM, to make them applicable in a broader context than a patient summary or even the MedMij context. An overview of the profiles can be found at the [[MedMij:V2018.03_FHIR_BGZ_2017#List_of_StructureDefinitions|list of StructureDefinitions]].

The patient journey of [https://www.nictiz.nl/ehealth/MedMij Thomas van Beek], provides a patients context for exchanging a patient summary from a healthcare provider's system (XIS) to a personal health record (PHR). MedMij created a [https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.03_Ontwerpen functional design] of the BgZ use case. This use case consists of enabling a patient to view his own BgZ in a PHR. This page will elaborate further on the HL7 FHIR details needed to exchange the BgZ information using FHIR.

==Actors involved==
{| class="wikitable"
! colspan="2" style="text-align:left;" | Actors
! colspan="2" style="text-align:left;" | Systems
! colspan="2" style="text-align:left;" | FHIR Capability Statements
|-
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
|-
| Patient
| The user of a personal healthcare enviorment.
| PHR
| Personal health record
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/NictizSTU3-Zib2017/bgz2017-clientcapabilities CapabilityStatement: Client]
| FHIR Client requirements
|-
| Healthcare professional
| The user of a XIS
| XIS
| Healthcare information system
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/NictizSTU3-Zib2017/bgz2017-servercapabilities CapabilityStatement: Server]
| FHIR Server requirements
|}

==Boundaries and Relationships==
The BgZ 2017 use case follows the BgZ 1.0 use case. The difference between the two is the underlying HCIMs, which have been upgraded from release 2015 to release 2017.

Release notes can be found here:https://github.com/Nictiz/Nictiz-STU3-Zib2017/raw/master/ReleaseNotes%20FHIR%20profielen%20ZIB2017.pdf

The BgZ use case has similarities and differences with other use cases such as Medication Process, Vital Signs and Lab Results. These use cases use the same HCIM based FHIR profiles for exchanging information. The BgZ use case covers practically all profiles included in the other use cases. However, the BgZ differs in the scope of the actual health information content that should be exchanged. For example, the BgZ conveys only the last known lab result of each type while the Lab Results use case may cover all known information.

==List of invocations==
[[Bestand:Afsprakenstelsel-01.png|link=https://www.medmij.nl/afsprakenstelsel/|rechts |100px|Go to Afsprakenstelsel]]

This FHIR implementation guide assumes that the PHR system is able to make a connection to the XIS that contains the patients BgZ information. It does not provide information on finding the right XIS nor does it provide information about security. These infrastructure and interface specifications are described in the [https://www.medmij.nl/afsprakenstelsel/ 'Afsprakenstelsel'].

===Client - PHR===
The PHR system requests the BgZ using individual search interactions. The BgZ consists of multiple FHIR resources with certain constraints. To obtain the patient's BgZ, the client can use multiple individual search operations based on specified search queries. The interaction can be performed by an HTTP GET or command as shown:

<code>GET [base]/[type]/{?[parameters]{&_format=[mime-type]}}</code>

The table below shows in the first four columns the BgZ sections, the HCIMs that constitute those sections and the specific content of the BgZ. The last column shows the FHIR search queries to obtain the BgZ information. These queries are based on StructureDefinitions listed in [[#List_of_StructureDefinitions| this section]].

Each query is performed in the context of a specific authenticated patient, for which an OAuth2 token has been retrieved using the Authentication mechanisms described in the [https://www.medmij.nl/afsprakenstelsel/ 'Afsprakenstelsel']. This token must be passed in each call in the HTTP header named “Authorization”. Each XIS Gateway is required to perform filtering based on the patient associated with the OAuth2 token received for the request, so that only the records associated with the authenticated patient are returned. Therefore, no search parameters should be passed for patient identification.
{| class="wikitable collapsible" width="100%" style="horizontal-align: right"
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | #
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | BgZ Section
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | HCIM EN
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | Content
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | Example Search URL
|-
| 1
| Patient information
| Patient
| BSN, birthdate, gender, deceasedindicator, contact details, marital status, and general practitioner (practitioner or organization)
| <pre>GET [base]/Patient?_include=Patient:general-practitioner</pre>
|-
| 2
| Payment details
| Payer
| Insurance information
| <pre>GET [base]/Coverage?_include=Coverage:payor:Patient&_include=Coverage:payor:Organization</pre>
|-
| rowspan="2" | 3
| rowspan="2" | Treatment Directives
| TreatmentDirective
| Known treatment directives
| <pre>GET [base]/Consent?category=http://snomed.info/sct|11291000146105</pre>
|-
| Advance directive
| Known advance directives
| <pre>GET [base]/Consent?category=http://snomed.info/sct|11341000146107</pre>
|-
| 4
| Contactperson
| Contact
| First relation/contact
| <pre style="font-style: italic;">see Patient</pre>
|-
| 5
| Functional status
| FunctionalOrMentalStatus
| Last known functional / mental status
| <pre>GET [base]/Observation$lastn?category=http://snomed.info/sct|118228005,http://snomed.info/sct|364644000</pre>
|-
| 6
| Problems
| Concern
| All known problems.
| <pre>GET [base]/Condition</pre>
|-
| rowspan="5" | 7
| rowspan="5" | Social history
| LivingSituation
| Current living situation
| <pre>GET [base]/Observation/$lastn?code=http://snomed.info/sct|365508006</pre>
|-
| DrugUse
| All known drug use
| <pre>GET [base]/Observation?code=http://snomed.info/sct|228366006</pre>
|-
| AlcoholUse
| All known alcohol use
| <pre>GET [base]/Observation?code=http://snomed.info/sct|228273003</pre>
|-
| TobaccoUse
| All known tobacco use
| <pre>GET [base]/Observation?code=http://snomed.info/sct|365980008</pre>
|-
| NutritionAdvice
| All known current dietary recommendations
| <pre>GET [base]/NutritionOrder?status=active</pre>
|-
| 8
| Alerts
| Alert
| All known alerts
| <pre>GET [base]/Flag</pre>
|-
| 9
| Allergies
| AllergyIntolerance
| All known information regarding allergies
| <pre>GET [base]/AllergyIntolerance</pre>
|-
| rowspan="3" | 10
| rowspan="3" | Medication
| MedicationUse
| Known medication use
| <pre>GET [base]/MedicationStatement?category=urn:oid:2.16.840.1.113883.2.4.3.11.60.20.77.5.3|6&_include:MedicationStatement:medication</pre>
|-
| MedicationAgreement
| Known medication agreements
| <pre>GET [base]/MedicationRequest?category=http://snomed.info/sct|16076005&_include:MedicationRequest:medication</pre>
|-
| AdministrationAgreement
| Known administration agreements
| <pre>GET [base]/MedicationDispense?category=http://snomed.info/sct|422037009&_include:MedicationDispense:medication</pre>
|-
| 11
| Medial aids
| MedicalAid
| All known medicalaids
| <pre>GET [base]/DeviceUseStatement?_include=DeviceUseStatement:device</pre>
|-
| 12
| Vaccinations
| Vaccination
| All known vaccinations
| <pre>GET [base]/Immunization?status=completed</pre>
|-
| rowspan="3" | 13
| rowspan="3" | Vital signs
| BloodPressure
| Last known bloodpressure
| <pre>GET [base]/Observation/$lastn?code=http://loinc.org|85354-9</pre>
|-
| BodyWeight
| Last known body weight
| <pre>GET [base]/Observation/$lastn?code=http://loinc.org|29463-7</pre>
|-
| BodyHeight
| Last known body height
| <pre>GET [base]/Observation/$lastn?code=http://loinc.org|8302-2,http://loinc.org|8306-3,http://loinc.org|8308-9</pre>
|-
| 14
| Results
| LaboratoryTestResult
| Last known laboratory results per type
| <pre>GET [base]/Observation/$lastn?category=http://snomed.info/sct|275711006&_include=Observation:related-target&_include=Observation:specimen</pre>
|-
| 15
| Procedures
| Procedure
| All surgical procedures
| <pre>GET [base]/Procedure?category=http://snomed.info/sct|365508006</pre>
|-
| 16
| Encounters
| Contact
| All hospital admissions (no outpatient contacts)
| <pre>GET [base]/Encounter?class=http://hl7.org/fhir/v3/ActCode|IMP,http://hl7.org/fhir/v3/ActCode|ACUTE,http://hl7.org/fhir/v3/ActCode|NONAC</pre>
|-
| rowspan="5" | 17
| rowspan="5" | Planned care
| rowspan="5" | PlannedCareActivity
| rowspan="5" | All known planned care activities
| <pre>GET [base]/ProcedureRequest?status=active</pre>
|-
| <pre>GET [base]/ImmunizationRecommendation</pre>
|-
| <pre>GET [base]/MedicationDispense?category=http://snomed.info/sct|422037009&status=in-progress,preparation</pre>
|-
| <pre>GET [base]/DeviceRequest?status=active</pre>
|-
| <pre>GET [base]/Appointment?status=booked,pending,proposed</pre>
|-
| 18
| General practitioner
| HealthProfessional
| General Practitioner of the patient
| <pre style="font-style: italic;">see Patient</pre>
|}

===Server - XIS===
Important sections of the FHIR specification for a server in this use case are the [http://hl7.org/fhir/STU3/http.html#2.21.0 RESTful API section] the [http://hl7.org/fhir/STU3/search.html search section] and [http://hl7.org/fhir/STU3/operations.html operation section] (for the nlast operation).

====Response to resource requests====
If the search succeeds, the server SHALL return a 200 OK HTTP status code and the returned content SHALL be a Bundle with type = searchset containing the results of the search as a collection of zero or more resources in a defined order. The returned content should conform to the StructureDefinition applicable for the specific HCIM request. The list of a StructureDefinitions relevant for this use case is shown in the following paragraph: [[#List_of_StructureDefinitions | List of StructureDefinitions]]

The result collection can be long, so servers may use paging. If they do, they SHALL use the method described below (adapted from RFC 5005 (Feed Paging and Archiving ) for breaking the collection into pages if appropriate. The server MAY also return an [http://hl7.org/fhir/stu3/operationoutcome.html OperationOutcome resource] within the searchset Bundle entries that contains additional information about the search; if one is sent it SHALL NOT include any issues with a fatal or error severity, and it SHALL be marked with a Bundle.entry.search.mode of outcome.

In order to allow the client to be confident about what search parameters were used as criteria by the server, the server SHALL return the parameters that were actually used to process the search. Applications processing search results SHALL check these returned values where necessary. For example, if the server did not support some of the filters specified in the search, a client might manually apply those filters to the retrieved result set, display a warning message to the user or take some other action.

In the case of a RESTful search, these parameters are encoded in the self-link in the bundle that is returned:
<pre>
<link>
<relation value="self"/>
<url value="http://example.org/Patient?identifier=[Patient-ID]/>
</link>
</pre>

Link to the relevant FHIR specification: http://hl7.org/fhir/STU3/http.html#search

====Handling errors====
If the search fails '''(cannot be executed, not that there are no matches)''', the return value is a status code 4xx or 5xx with an OperationOutcome. An HTTP status code of 403 signifies that the server refused to perform the search, while other 4xx and 5xx codes signify that some sort of error has occurred. The HTTP status code 404 is returned if a XIS did not implement an endpoint used in a request by a PHR. When the search fails, a server SHOULD return an OperationOutcome detailing the cause of the failure. For example, in case of a not implemented FHIR endpoint, the OperationOutcome would state that the resource type is not supported. Note: an empty search result is not a failure.

Common HTTP Status codes returned on FHIR-related errors (in addition to normal HTTP errors related to security, header and content type negotiation issues):

* 400 Bad Request - search could not be processed or failed basic FHIR validation rules
* 401 Not Authorized - authorization is required for the interaction that was attempted
* 404 Not Found - resource type not supported, or not a FHIR end-point

In some cases, parameters may cause an error. For instance:

* A parameter may refer to a non-existent resource e.g. <code>GET [base]/Observation?subject=101</code>, where "101" does not exist
* A parameter may refer to an unknown code e.g. <code>GET [base]/Observation?code=loinc|1234-1</code>, where the LOINC code "1234-1" is not known to the server
* A parameter may refer to a time that is out of scope e.g. <code>GET [base]/Condition?onset=le1995</code>, where the system only has data going back to 2001
* A parameter may use an illegal or unacceptable modifier e.g. <code>GET [base]/Condition?onset:text=1995</code>, where the modifier cannot be processed by the server
* A data time parameter may have incorrect format e.g. <code>GET [base]/Condition?onset=23%20May%202009</code>
* A parameter may be unknown or unsupported
Where the content of the parameter is syntactically incorrect, servers SHOULD return an error. However, where the issue is a logical condition (e.g. unknown subject or code), the server SHOULD process the search, including processing the parameter - with the result of returning an empty search set, since the parameter cannot be satisfied.

In such cases, the search process MAY include an OperationOutcome in the search set that contains additional hints and warnings about the search process. This is included in the search results as an entry with search mode = outcome. Clients can use this information to improve future searches.

Link to relevant FHIR specification: http://hl7.org/fhir/STU3/search.html#errors

==Interactions, operations, search parameters==

===Interactions===

The following logical interactions are needed for the BgZ use case:
* [http://hl7.org/fhir/STU3/http.html#search Search]

===Operations===
The following [http://hl7.org/fhir/STU3/operations.html operation] is needed to support this use case.
* [http://hl7.org/fhir/STU3/observation-operations.html#lastn Last N Observations Query]

The lastn query meets the common need for searching for the most recent or last n=number of observations for a subject. For example, retrieving the last 5 temperatures for a patient to view trends or fetching the most recent laboratory results or vital signs. The link will provide more detailed information and examples regarding this operation.

===Search parameters===
The following search parameter types and search result parameters need to be supported for this use case.

Search parameter types:
* [http://hl7.org/fhir/STU3/search.html#token token]
** Including modifier 'in'
* [http://hl7.org/fhir/STU3/search.html#reference reference]

Search result parameters:
* [http://hl7.org/fhir/STU3/search.html#include _include]
* [http://hl7.org/fhir/STU3/search.html#include _revinclude]

==List of StructureDefinitions==
The profiles represent their entire respective HCIM, to make them applicable in a broader context than the exchange of BgZ or a MedMij context. An example of reuse of existing profiles are those of the patient administration resources and vital signs.

{| class="wikitable" style="horizontal-align: right"
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | Section
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:100px" | ZIB NL
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:100px" | HCIM EN
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:100px" | FHIR Resource
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:400px" | FHIR Profile
|-
| 01
| Patient
| #ZIB Patient|Patient
| Patient
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
|-
| rowspan="3" |02
| rowspan="3" | Betaler
| rowspan="3" | Payer
| Coverage
| [https://simplifier.net/NictizSTU3-Zib2017/zib-Payer http://nictiz.nl/fhir/StructureDefinition/zib-Payer]
|-
| Organization
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
|-
| Patient
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
|-
| rowspan="2" |03
| BehandelAanwijzing
| TreatmentDirective
| Consent
| [https://simplifier.net/NictizSTU3-Zib2017/zib-TreatmentDirective http://nictiz.nl/fhir/StructureDefinition/zib-TreatmentDirective]
|-
| Wilsverklaring
| AdvanceDirective
| Consent
| [https://simplifier.net/NictizSTU3-Zib2017/zib-AdvanceDirective http://nictiz.nl/fhir/StructureDefinition/zib-AdvanceDirective]
|-
| 04
| Contactpersoon
| Contact
| RelatedPerson
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-relatedperson http://fhir.nl/fhir/StructureDefinition/nl-core-relatedperson]
|-
| 05
| Funct. OfMentaleStatus
| FunctionalOrMentalStatus
| Observation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-FunctionalOrMentalStatus http://nictiz.nl/fhir/StructureDefinition/zib-FunctionalOrMentalStatus]
|-
| 06
| Probleem
| Problem
| Condition
| [https://simplifier.net/NictizSTU3-Zib2017/zib-Problem http://nictiz.nl/fhir/StructureDefinition/zib-Problem]
|-
| rowspan="5" | 07
| Woonsituatie
| LivingSituation
| Observation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-LivingSituation http://nictiz.nl/fhir/StructureDefinition/zib-LivingSituation]
|-
| DrugsGebruik
| DrugUse
| Observation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-DrugUse http://nictiz.nl/fhir/StructureDefinition/zib-DrugUse]
|-
| AlcoholGebruik
| AlcoholUse
| Observation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-AlcoholUse http://nictiz.nl/fhir/StructureDefinition/zib-AlcoholUse]
|-
| TabakGebruik
| TobaccoUse
| Observation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-TobaccoUse http://nictiz.nl/fhir/StructureDefinition/zib-TobaccoUse]
|-
| Voedingsadvies
| NutritionAdvice
| NutritionOrder
| [https://simplifier.net/NictizSTU3-Zib2017/zib-NutritionAdvice http://nictiz.nl/fhir/StructureDefinition/zib-NutritionAdvice]
|-
| 08
| Alert
| Alert
| Flag
| [https://simplifier.net/NictizSTU3-Zib2017/zib-Alert http://nictiz.nl/fhir/StructureDefinition/zib-Alert]
|-
| 09
| AllergieIntolerantie
| AllergyIntolerance
| AllergyIntolerance
| [https://simplifier.net/NictizSTU3-Zib2017/zib-AllergyIntolerance http://nictiz.nl/fhir/StructureDefinition/zib-AllergyIntolerance]
|-
| rowspan="3" | 10
| rowspan="3" | MedicatieGebruik
| MedicationUse
| MedicationStatement
| [https://simplifier.net/NictizSTU3/zib-MedicationUse http://nictiz.nl/fhir/StructureDefinition/zib-MedicationUse]
|-
| MedicationAgreement
| MedicationRequest
| [https://simplifier.net/NictizSTU3/zib-MedicationAgreement http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAgreement]
|-
| AdministrationAgreement
| MedicationDispense
| [https://simplifier.net/NictizSTU3/zib-AdministrationAgreement http://nictiz.nl/fhir/StructureDefinition/zib-AdministrationAgreement]
|-
| rowspan="2" | 11
| rowspan="2" | MedischHulpmiddel
| rowspan="2" | MedicalDevice
| Device
| [https://simplifier.net/NictizSTU3-Zib2017/ZIB-MedicalDevice-Product http://nictiz.nl/fhir/StructureDefinition/zib-MedicalDeviceProduct]
|-
| DeviceUseStatement
| [https://simplifier.net/NictizSTU3-Zib2017/zib-MedicalDevice http://nictiz.nl/fhir/StructureDefinition/zib-MedicalDevice]
|-
| rowspan="2" | 12
| rowspan="2" | Vaccinatie
| rowspan="2" | Vaccination
| Immunization
| [https://simplifier.net/NictizSTU3-Zib2017/zib-Vaccination http://nictiz.nl/fhir/StructureDefinition/zib-Vaccination]
|-
| ImmunizationRecommendation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-VaccinationRecommendation http://nictiz.nl/fhir/StructureDefinition/zib-VaccinationRecommendation]
|-
| rowspan="3" | 13
| Bloeddruk
| BloodPressure
| Observation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-BloodPressure http://nictiz.nl/fhir/StructureDefinition/zib-BloodPressure]
|-
| LichaamsGewicht
| BodyWeight
| Observation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-BodyWeight http://nictiz.nl/fhir/StructureDefinition/zib-BodyWeight]
|-
| LichaamsLengte
| BodyHeight
| Observation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-BodyHeight http://nictiz.nl/fhir/StructureDefinition/zib-BodyHeight]
|-
| rowspan="2" | 14
| rowspan="2" | LaboratoriumUitslag
| rowspan="2" | LaboratoryTestResult
| Observation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-LaboratoryTestResult-Observation http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Observation]
|-
| Specimen
| [https://simplifier.net/NictizSTU3-Zib2017/zib-LaboratoryTestResult-Specimen http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Specimen]
|-
| 15
| Verrichting
| Procedure
| Procedure
| [https://simplifier.net/NictizSTU3-Zib2017/zib-Procedure http://nictiz.nl/fhir/StructureDefinition/zib-Procedure]
|-
| 16
| Contact
| Encounter
| Encounter
| [https://simplifier.net/NictizSTU3-Zib2017/zib-Encounter http://nictiz.nl/fhir/StructureDefinition/zib-Encounter]
|-
| rowspan="5" | 17
| rowspan="5" | GeplandeZorgActiviteit
| rowspan="5" | PlannedCareActivity
| ProcedureRequest
| [https://simplifier.net/NictizSTU3-Zib2017/zib-ProcedureRequest http://nictiz.nl/fhir/StructureDefinition/zib-ProcedureRequest]
|-
| MedicationRequest
| [https://simplifier.net/NictizSTU3/zib-MedicationAgreement http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAgreement]
|-
| ImmunizationRecommendation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-VaccinationRecommendation http://nictiz.nl/fhir/StructureDefinition/zib-VaccinationRecommendation]
|-
| DeviceRequest
| [https://simplifier.net/NictizSTU3-Zib2017/zib-MedicalDevice-Request http://nictiz.nl/fhir/StructureDefinition/zib-MedicalDeviceRequest]
|-
| Appointment
| [https://simplifier.net/NictizSTU3/eAfspraken-Appointment http://nictiz.nl/fhir/StructureDefinition/eAfspraken-Appointment]
|-
| rowspan="3" | 18
| rowspan="2" | Zorgverlener
| rowspan="2" | HealthProfessional
| Practitioner
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
|-
| PractitionerRole
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-practitionerrole http://fhir.nl/fhir/StructureDefinition/nl-core-practitionerrole]
|-
| Zorgaanbieder
| HealthcareProvider
| Organization
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
|}

==Terminology, NamingSystems, Mappings==

===Terminology===
Relevant value sets can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=ValueSet here]. All resources can be downloaded in a .zip in XML or JSON format. In the .zip, the value sets are stored in the directory 'value sets'.

===NamingSystems===
Relevant NamingSystems can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=NamingSystem here].

===Mappings===
Relevant HCIM to FHIR value set mappings can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=ConceptMap here].
All profiles include HCIM mappings. HCIM concepts are mapped to the corresponding FHIR elements using the HCIMs concept id. The top of the StructureDefinition contains meta information regarding the HCIM mapping, such as the name and uri of the HCIM. In the StructureDefinition elements, the corresponding HCIM ID is given including the mapping meta information id. This is illustrated in the following example.

<pre>
<StructureDefinition>
<id value="nl-core-patient" />
.....
<mapping>
<identity value="hcim-patient-v3.1-2017EN"/>
<uri value="https://zibs.nl/wiki/Patient-v3.1(2017EN)"/>
<name value="HCIM Patient-v3.1(2017EN)"/>
</mapping>
.....
<element id="Patient.name">
<path value="Patient.name" />
<short value="NameInformation" />
<alias value="Naamgegevens" />
<type>
<code value="HumanName" />
<profile value="http://fhir.nl/fhir/StructureDefinition/nl-core-humanname" />
</type>
<mapping>
<identity value="hcim-patient-v3.1-2017EN"/>
<map value="NL-CM:0.1.6"/>
</mapping>
</element>
.....
</StructureDefinition>
</pre>

[[categorie:MedMij FHIR Use Cases]]

MedMij:V2018.02 FHIR MedicationProcess

2018-04-16T11:58:55Z

Marten Smits:

{{#customtitle:MedMij FHIR use case Medication Process}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:Medication_Icoon.png|link=|85px|links|Use case Medication|Medication process]]
<imagemap>Bestand:Leeswijzer-technisch-banner 03 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.02_OntwerpMedicatie|Functional]]
circle 1787 230 212 [[MedMij:V2018.02_FHIR_IG|Tecnical]]
desc none
</imagemap>

__TOC__

=Introduction=
[[Bestand:Functioneel-02.png|link=MedMij:V2018.02_Ontwerpen |100px|rechts|Functional design|Go to functional design]]

This page describes patient's use cases, in a personal health environment (PHE) context, in relation to the information standard [https://informatiestandaarden.nictiz.nl/wiki/Landingspagina_Medicatieproces Medication Process] (MP). These use cases are based on version 9.x of this standard. Functional specification of these use cases are described at the [[MedMij:V2018.02_Ontwerpen| functional design wiki page]]. The technical specification is described here. HL7 FHIR STU3 is used for this purpose.

The Medication Process information building blocks are adopted by 'Registratie aan de Bron' and converted to Health and Care Information models, also called ZIB's. In order to exchange medication information between systems, FHIR representations of these ZIB's are made and used in the transactions described on this page.

Use cases:
* [[MedMij:V2018.02_FHIR_MedicationProcess#Use_case:_retrieve_medication_overview|Retrieve a medication overview]]
* [[MedMij:V2018.02_FHIR_MedicationProcess#Use_case:_retrieve_medication_information|Retrieve medication information]]

=Actors involved=
{| class="wikitable"
! colspan="2" style="text-align:left;" | Persons
! colspan="2" style="text-align:left;" | Systems
! colspan="2" style="text-align:left;" | FHIR Capability Statements
|-
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
|-
| Patient
| The user of a personal healthcare enviorment.
| PHR
| Personal health record
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/NictizSTU3/medication-clientcapabilities CapabilityStatement: Client]
| Medication process client requirements
|-
| Healthcare professional
| The user of a XIS
| XIS
| Healthcare information system
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/NictizSTU3/medication-servercapabilities CapabilityStatement: Server]
| Medication process server requirements
|}

=Use case: retrieve medication overview=
{{FHIR-IG-Afsprakenstelsel-Note}}

==Introduction==
The retrieve medication overview transaction is used by the PHR to retrieve a medication overview from the XIS.

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transaction group'''
! style="text-align:left;"| '''Transaction'''
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Retrieve Medication Overview(PULL)
|style="background-color: white;vertical-align:top;"|Retrieve medication overview request
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Request medication overview from the XIS
|-
|style="background-color: white;vertical-align:top;"|Retrieve medication overview response
|style="background-color: white;vertical-align:top;"|Healthcare professional (using a XIS)
|style="background-color: white;vertical-align:top;"|Serves medication overview to the PHR
|}

==Invocations==
===PHR: request message===
This message uses an extended operation on the RESTful API to obtain a medication overview from a XIS. This operation is used because the XIS needs to play an active role in formulating the content of the response.

====Trigger Events====
When the patient(PHR) wants to obtain the current medication overview, it issues a retrieve medication overview request message.

====Message Semantics====
The PHR executes a medication-overview operation with HTTP POST against the XIS's base endpoint as shown below.

<pre>
POST [base]/$medication-overview
</pre>

=====Expected Actions=====
The XIS shall process the operation to find or generate and return the current medication overview.

===XIS: response message===
The XIS returns a HTTP Status code appropriate to the processing of the operation as well as a Bundle of type 'collection', containing one List and one Patient resource along with other resources that represent the Medication Overview.

====Trigger Events====
The XIS completed processing of the retrieve medication overview request message.

====Message Semantics====
Based on the medication-overview operation processing results, the XIS will either return an error or success. When the XIS needs to report an error, it shall use HTTP error response codes and shall include a FHIR OperationOutcome resource with more details on the failure. If the request message is processed successfully, whether or not a Medication Overview is found or generated, the HTTP status code shall be 200.

The body of the response message shall be a Bundle resource of type "collection". The following section will elaborate on the content included.

If the XIS is sending warnings, the Bundle resource shall also contain a FHIR OperationOutcome resource that contains those warnings. The FHIR specification describes the relevant sections:
*[http://hl7.org/fhir/STU3/http.html RESTful API framework]
*[http://hl7.org/fhir/operations.html Operations]
*[http://hl7.org/fhir/STU3/bundle.html Bundle resource]
*[http://hl7.org/fhir/operationoutcome.html OperationOutcome resource]

=====Message content=====
The outcome of the [https://simplifier.net/NictizSTU3/Medication-Overview medication-overview operation] is the body of the medication overview request message. Successful processing of this operation should result in a Bundle recourse, containing one List and one Patient resource as entries along with all the resources that represent the current medication overview. These resources SHALL be referenced from the List resource. The clinical content of the medication overview is defined in the [https://informatiestandaarden.nictiz.nl/wiki/mp:V9.04_Ontwerp_medicatieproces#Medicatieoverzicht_en_afleidingsregels Medication Process specification]. The functional dataset of the medication overview can be found on [http://decor.nictiz.nl/medicatieproces/mp-html-20170829T141253/tr-2.16.840.1.113883.2.4.3.11.60.20.77.4.148-2016-11-08T103441.html decor.nictiz.nl].

<html>
<iframe width="750" frameborder="1" height="400" src=https://www.simplifier.net/embed/render?id=NictizSTU3/Medication-Overview frameborder="0" align="middle"></iframe>
</html>

The content in the response message SHALL be a valid instance of the following profiles. Clicking on the link will open the formal definition on Simplifier.net.

* '''Bundle profile:''' [https://simplifier.net/NictizSTU3/Bundle-MedicationOverview http://nictiz.nl/fhir/StructureDefinition/Bundle-MedicationOverview]
* '''List profile:''' [https://simplifier.net/NictizSTU3/List-MedicationOverview http://nictiz.nl/fhir/StructureDefinition/MedicationOverview]

The Bundle profile represents the structure of the retrieve medication overview response message. The List profile represents the actual medication overview. The List contains the medication overview metadata and references to all resources that constitute the medication overview. These resources are included in the Bundle as entries. The returned Bundle has at least one List and one Patient resource.

All returned resources to the PHR, including the Bundle and List, SHALL include their related profile canonical URL in the ''meta.profile'' element in order to show compliance. The resources in the response message SHALL be a valid instance of these profiles. In the table below, the ZIB's that constitute the clinical content of the Medication Overview and their respective profiles are listed.

'''Note''' that the medication building blocks are grouped per 'medication treatment' conform the [https://informatiestandaarden.nictiz.nl/wiki/mp:V9.04_Ontwerp_medicatieproces#Medicamenteuze_behandeling Medication Process specification]. Grouping SHALL be done by use of a 'medication treatment' identifier. This identifier shall be the same across different related medication resources that constitute a medication treatment. The [https://simplifier.net/NictizSTU3/zib-Medication-MedicationTreatment zib-Medication-MedicationTreatment extenstion] is added to all medication profiles and can be used for this grouping purpose.

{| class="wikitable"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|ZIB name NL||ZIB name EN||FHIR Resource||URL profile||Reference to section
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Patient
| #ZIB Patient|Patient
| Patient
| [https://simplifier.net/NictizSTU3/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_Patient | Patient]]
|-
| Zorgverlener
| HealthProfessional
| Practitioner
| [https://simplifier.net/NictizSTU3/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_HealthProfessional | HealthProfessional]]
|-
| Zorgaanbieder
| HealthcareProvider
| Organization
| [https://simplifier.net/NictizSTU3/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
| [[Bestand: Verwijzing.png| 20px]][[MedMij:V1.0_FHIR_HealthcareProvider | HealthcareProvider]]
|-
| Medicatiegebruik||MedicationUsage||MedicationStatement|| [https://simplifier.net/NictizSTU3/zib-MedicationUse http://nictiz.nl/fhir/StructureDefinition/zib-MedicationUse]|| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_MedicationUse | MedicationUse]]
|-
| Toedieningsafspraak||AdministrationAgreement||MedicationDispense|| [https://simplifier.net/NictizSTU3/zib-AdministrationAgreement http://nictiz.nl/fhir/StructureDefinition/zib-AdministrationAgreement]|| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_AdministrationAgreement | AdministrationAgreement]]
|-
| Medicatieafspraak||MedicationAgreement||MedicationRequest|| [https://simplifier.net/NictizSTU3/zib-MedicationAgreement http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAgreement] || [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_MedicationAgreement | MedicationAgreement]]
|-
| Product||Product||Medication|| [https://simplifier.net/NictizSTU3/zib-product http://nictiz.nl/fhir/StructureDefinition/zib-Product]|| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_Product | Product]]
|-
| GebruiksInstructie||InstructionsForUse||Dosage (datatype)|| [https://simplifier.net/NictizSTU3/zib-InstructionsForUse http://nictiz.nl/fhir/StructureDefinition/zib-InstructionsForUse]|| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_InstructionsForUse | InstructionsForUse]]
|-
|}

====Expected Actions====
The PHE processes the results according to application-defined rules. The PHR should be robust as the response may contain medication information resources as mentioned in the former section.

==Interactions, operations, search parameters==
===Interactions===
No interactions are needed for the retrieve medication overview transaction.

===Operations===
The retrieve medication overview medication operation is used for this transaction. The formal definition can be found here:
* [https://simplifier.net/NictizSTU3/Medication-Overview medication-overview]

===Search parameters===
The following search parameter type needs to be supported for this transaction.

Search parameter types:
* [http://hl7.org/fhir/STU3/search.html#token token]

=Use case: retrieve medication information=
{{FHIR-IG-Afsprakenstelsel-Note}}

==Introduction==
The Retrieve Medication Information transaction is used by the PHR to retrieve medication information from the XIS. The PHR can use this transaction to retrieve the wanted information by searching on specific medication building blocks.

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transaction group'''
! style="text-align:left;"| '''Transaction'''
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Retrieve Medication Information(PULL)
|style="background-color: white;vertical-align:top;"|Retrieve medication information request
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Request medication information from the XIS
|-
|style="background-color: white;vertical-align:top;"|Retrieve medication information response
|style="background-color: white;vertical-align:top;"|Healthcare professional (using a XIS)
|style="background-color: white;vertical-align:top;"|Serves medication information to the PHR
|}

==Invocations==
===PHR: request message===
This message uses the HTTP GET method parameterized query to obtain medication information from a XIS. Multiple different HTTP GET request messages may be needed to retrieve all medication information.

====Trigger Events====
When the patient(PHR) wants to obtain medication information matching various parameters, it issues a retrieve medication information request message.

====Message Semantics====
The PHR executes an HTTP GET against the XIS's medication FHIR endpoints. These endpoints can be one of the following:
* MedicationRequest
* MedicationAdministration
* MedicationDispense
* MedicationStatement

The search interaction is performed by an HTTP GET conform the [http://hl7.org/fhir/STU3/search.html FHIR search specification] as shown:

<pre>
GET [base]/[type]{?[parameters]{&_format=[mime-type]}}
</pre>

This URL is configurable by the PHR by configuring the query search parameters and search control parameters to modify the behavior of the XIS such as response format, or pagination. An example of a search for MedicationRequest resources:

<pre>
GET https://vonk.test-nictiz.nl/MedicationRequest?date=gt2010-10-01
</pre>

This search interaction will finds any MedicationRequest resources changed since 1-Oct 2010.

=====Including other resources in searchresults=====
The PHR may request that the XIS return resources related to the search results, in order to reduce the overall network delay of repeated retrievals of related resources. This is useful when the PHR is searching on a clinical resource, but for every such resource returned, the client will also need the subject (Patient resource) or prescriber (Practitioner resource) or medication that the clinical resource refers to. The client can use the _include parameter to indicate that the subject resources be included in the results. Example search:

<pre>
GET [base]/MedicationRequest?&category=http://snomed.info/sct|16076005&_include:MedicationRequest:medication
</pre>

This search interaction will find all MedicationRequest resources of the category MedicationAgreement and if present include the referenced Medication resource.

====Query Search Parameters====
The PHR may supply, and the XIS SHALL be capable of processing, all query parameters listed in the table below. The XIS may choose to support additional query parameters beyond the subset listed below. Any additional query parameters supported shall be supported according to the core FHIR specification. Such additional parameters are considered out of scope for this transaction.

{| class="wikitable"
! style="font-weight: bold;text-align:left;" | MP9 search parameters
! style="font-weight: bold;text-align:left;" | Description
! style="font-weight: bold;text-align:left;" | FHIR search parameter
! style="font-weight: bold;text-align:left;" | FHIR resource
|-
| Identification
| Search on identifier.
| identifier
| MedicationRequest, MedicationDispense, MedicationAdministration, MedicationStatement
|-
| Type
| Search on type of medication building block (HCIM).
| category '''*''' / '''**'''
| MedicationRequest, MedicationAdministration, MedicationDispense, MedicationStatement
|-
| ProductCode
| Search on medication code.
| code
| MedicationRequest, MedicationAdministration, MedicationDispense, MedicationStatement, Medication
|-
| UsePeriod
| Search on medication use in the past, present or future within the specified time period.
| periodofuse '''**'''
| MedicationDispense, MedicationRequest
|-
| DispensePeriod
| Returns all medication dispenses within the specific period.
| whenhandedover
| MedicationDispense
|}
'''*''' The FHIR profiles that represent the medication building blocks contain fixed code values in the ''.category'' elements to allow searching on specific medication building blocks. FHIR resources MedicationAdministration and MedicationDispense do not contain a 'category' search parameter in the FHIR specification. Custom search parameters are provided.

'''**''' The search parameter consists of a custom created FHIR search parameter not represented in the FHIR specification.

=====Custom Search Parameters=====

The follow custom search parameters are defined for this use case:

* https://simplifier.net/NictizSTU3/Medications-category
* https://simplifier.net/NictizSTU3/Medications-periodofuse

=====Search on fixed category code=====
To distinguish the ZIB medication building blocks between general medication resources, a fixed category coding has been added to the ZIB medication profiles. This fixed category code is solely used for indexing and retrieval of the ZIB building blocks. These category codings be found in the in the profiles at the .category element. The profiles are listed at the response message section below.

====Example Searches====

'''Identifier'''
<pre>1. https://vonk.test-nictiz.nl/MedicationRequest?identifier=http://example.nl/fhir/NamingSystem/MedicationRequest|999922448 </pre>
# Retrieves a MedicationRequest resource with the identifier 999922448.

'''Type'''
<pre>1. https://vonk.test-nictiz.nl/MedicationRequest
2. https://vonk.test-nictiz.nl/MedicationRequest?category=http://snomed.info/sct|16076005</pre>
# Retrieves all MedicationRequest resources.
# Retrieves all MedicationRequest resources that represent a ZIB MedicationAgreement.

'''ProductCode'''
<pre>1. https://vonk.test-nictiz.nl/MedicationRequest?medication.code=urn:oid:2.16.840.1.113883.2.4.4.8|13610554
2. https://vonk.test-nictiz.nl/MedicationRequest?include=Medication:medication&code=urn:oid:2.16.840.1.113883.2.4.4.8|13610554
3. https://vonk.test-nictiz.nl/MedicationRequest?category=http://snomed.info/sct|16076005&medication.code=urn:oid:2.16.840.1.113883.2.4.4.8|13610554</pre>
# Retrieves all MedicationRequest resources that have Carbasalaatcalcium Sandoz 600 30 as medication.
# Retrieves all MedicationRequest resources that have Carbasalaatcalcium Sandoz 600 30 as medication and includes the Medication resource in the search results.
# Retrieves all MedicationRequest resources that represent a ZIB MedicationAgreement and have Carbasalaatcalcium Sandoz 600 30 as medication

'''UsePeriod'''
<pre>1. https://vonk.test-nictiz.nl/MedicationRequest?periodofuse=ge2010-01-01
2. https://vonk.test-nictiz.nl/MedicationDispense?periodofuse=ge2010-01-01&periodofuse=le2011-12-31
3. https://vonk.test-nictiz.nl/MedicationRequest?category=http://snomed.info/sct|16076005&periodofuse=ge2010-01-01</pre>
# Retrieves all MedicationRequest resources that were in effect after 01-01-2010.
# Retrieves all MedicationDispense resources that were in effect within a 2 year period.
# Retrieves all MedicationRequest resources that represent a ZIB MedicationAgreement and were in effect after 01-01-2010.

'''DispensePeriod'''
<pre>1. https://vonk.test-nictiz.nl/MedicationDispense?whenhandedover=ge2010-01-01
2. https://vonk.test-nictiz.nl/MedicationDispense?whenhandedover=ge2010-01-01&whenhandedover=le2011-12-31
3. https://vonk.test-nictiz.nl/MedicationDispense?whenhandedover=ge2010-01-01&category=http://snomed.info/sct|373784005
</pre>
# Retrieves all MedicationDispense resources that were handed over after 01-01-2010.
# Retrieves all MedicationDispense resources that were handed over within a 2 year period.
# Retrieves all MedicationDispense resources that represent a ZIB Dispense and were handed over after 01-01-2010.

=====Expected Actions=====
The XIS shall process the query to discover the medication information that match the search parameters given.

===XIS: response message===
The XIS returns a HTTP Status code appropriate to the processing as well as a FHIR Bundle including the matching medication information.

====Trigger Events====
The XIS completed processing of the Retrieve medication information request message.

====Message Semantics====
Based on the query results, the XIS will either return an error or success. When the XIS needs to report an error, it SHALL use HTTP error response codes and SHOULD include a FHIR OperationOutcome resource with more details on the failure. If the request message is processed successfully, whether or not any medication resources are found, the HTTP status code SHALL be 200.

The response message SHALL be a Bundle resource of type "searchset" containing zero or more FHIR resources as entries. If the XIS is sending warnings, the Bundle resource SHALL also contain a FHIR OperationOutcome resource that contains those warnings. The FHIR specification describes the relevant sections:
*[http://hl7.org/fhir/STU3/http.html RESTful API framework]
*[http://hl7.org/fhir/STU3/search.html#errors Search errors]
*[http://hl7.org/fhir/STU3/bundle.html Bundle resource]
*[http://hl7.org/fhir/operationoutcome.html OperationOutcome resource]

=====Message resource content=====
The returned data to the PHR should conform to the medication ZIBs profiles. In the table below the medication ZIB's and their respective FHIR profiles are listed. The resources in the response message SHALL be a valid instance of these profiles. All resources SHALL include their related profile canonical URL in the ''meta.profile'' element in order to show compliance.

'''Note''' that the medication building blocks are grouped per 'medication treatment' conform the [https://informatiestandaarden.nictiz.nl/wiki/mp:V9.04_Ontwerp_medicatieproces#Medicamenteuze_behandeling Medication Process specification]. Grouping SHALL be done by use of a 'medication treatment' identifier. This identifier shall be the same across different related medication resources that constitute a medication treatment. The [https://simplifier.net/NictizSTU3/zib-Medication-MedicationTreatment zib-Medication-MedicationTreatment extenstion] is added to all medication profiles and can be used for this grouping purpose.

{| class="wikitable" width="1400px"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|ZIB name NL||ZIB name EN||FHIR Resource||URL profile||Reference to section
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Patient
| #ZIB Patient|Patient
| Patient
| [https://simplifier.net/NictizSTU3/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_Patient | Patient]]
|-
| Zorgverlener
| HealthProfessional
| Practitioner
| [https://simplifier.net/NictizSTU3/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_HealthProfessional | HealthProfessional]]
|-
| Zorgaanbieder
| HealthcareProvider
| Organization
| [https://simplifier.net/NictizSTU3/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
| [[Bestand: Verwijzing.png| 20px]][[MedMij:V1.0_FHIR_HealthcareProvider | HealthcareProvider]]
|-
| Medicatiegebruik||MedicationUsage||MedicationStatement|| [https://simplifier.net/NictizSTU3/zib-MedicationUse http://nictiz.nl/fhir/StructureDefinition/zib-MedicationUse]|| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_MedicationUse | MedicationUse]]
|-
| Medicatietoediening||MedicationAdministration||MedicationAdministration|| [https://simplifier.net/NictizSTU3/zib-MedicationAdministration http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAdministration] || [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_MedicationAdministration | MedicationAdministration]]
|-
| Toedieningsafspraak||AdministrationAgreement||MedicationDispense|| [https://simplifier.net/NictizSTU3/zib-AdministrationAgreement http://nictiz.nl/fhir/StructureDefinition/zib-AdministrationAgreement]|| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_AdministrationAgreement | AdministrationAgreement]]
|-
| Medicatieafspraak||MedicationAgreement||MedicationRequest|| [https://simplifier.net/NictizSTU3/zib-MedicationAgreement http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAgreement] || [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_MedicationAgreement | MedicationAgreement]]
|-
| Verstrekking||Dispense||MedicationDispense|| [https://simplifier.net/NictizSTU3/zib-Dispense http://nictiz.nl/fhir/StructureDefinition/zib-Dispense]|| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_Dispense | Dispense]]
|-
| Verstrekkingsverzoek||MedicationDispenseRequest||MedicationRequest|| [https://simplifier.net/NictizSTU3/zib-DispenseRequest http://nictiz.nl/fhir/StructureDefinition/zib-DispenseRequest]|| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_MedicationDispenseRequest | DispenseRequest]]
|-
| Product||Product||Medication|| [https://simplifier.net/NictizSTU3/zib-product http://nictiz.nl/fhir/StructureDefinition/zib-Product]|| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_Product | Product]]
|-
| GebruiksInstructie||InstructionsForUse||Dosage (datatype)|| [https://simplifier.net/NictizSTU3/zib-InstructionsForUse http://nictiz.nl/fhir/StructureDefinition/zib-InstructionsForUse]|| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_InstructionsForUse | InstructionsForUse]]
|-
|}

====Expected Actions====
The PHR shall process the results according to application-defined rules. The PHR should be robust as the response may contain medication information resources that match the query parameters.

==Interactions, operations, search parameters==
===Interactions===
The following logical interactions are needed for the retrieve medication information transaction:
* [http://hl7.org/fhir/STU3/http.html#search Search]

===Operations===
No operations are defined or needed for this transaction.

===Search parameters===
The following search parameter types and search result parameters need to be supported for this transaction.

Search parameter types:
* [http://hl7.org/fhir/STU3/search.html#token token]
* [http://hl7.org/fhir/STU3/search.html#date date]

Search result parameters:
* [http://hl7.org/fhir/STU3/search.html#include _include]

[[categorie:MedMij FHIR Use Cases]]

MedMij:V2018.02 FHIR MedicationProcess

2018-04-16T11:57:18Z

Marten Smits: /* Actors */

{{#customtitle:MedMij FHIR use case Medication Process}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:Medication_Icoon.png|link=|85px|links|Use case Medication|Medication process]]
<imagemap>Bestand:Leeswijzer-technisch-banner 03 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.02_OntwerpMedicatie|Functional]]
circle 1787 230 212 [[MedMij:V2018.02_FHIR_IG|Tecnical]]
desc none
</imagemap>

__TOC__

=Introduction=
[[Bestand:Functioneel-02.png|link=MedMij:V2018.02_Ontwerpen |100px|rechts|Functional design|Go to functional design]]

This page describes patient's use cases, in a personal health environment (PHE) context, in relation to the information standard [https://informatiestandaarden.nictiz.nl/wiki/Landingspagina_Medicatieproces Medication Process] (MP). These use cases are based on version 9.x of this standard. Functional specification of these use cases are described at the [[MedMij:V2018.02_Ontwerpen| functional design wiki page]]. The technical specification is described here. HL7 FHIR STU3 is used for this purpose.

The Medication Process information building blocks are adopted by 'Registratie aan de Bron' and converted to Health and Care Information models, also called ZIB's. In order to exchange medication information between systems, FHIR representations of these ZIB's are made and used in the transactions described on this page.

Use cases:
* [[MedMij:V2018.02_FHIR_MedicationProcess#Use_case:_retrieve_medication_overview|Retrieve a medication overview]]
* [[MedMij:V2018.02_FHIR_MedicationProcess#Use_case:_retrieve_medication_information|Retrieve medication information]]

=Actors involved=
{| class="wikitable"
! colspan="2" style="text-align:left;" | Persons
! colspan="2" style="text-align:left;" | Systems
! colspan="2" style="text-align:left;" | FHIR Capability Statements
|-
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
|-
| Patient
| The user of a personal healthcare enviorment.
| PHR
| Personal health record
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/NictizSTU3/medication-clientcapabilities CapabilityStatement: Client]
| Medication process client requirements
|-
| Healthcare professional
| The user of a XIS
| XIS
| Healthcare information system
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/NictizSTU3/medication-servercapabilities CapabilityStatement: Server]
| Medication process server requirements
|}

=Use case: retrieve medication overview=
{{FHIR-IG-Afsprakenstelsel-Note}}

==Introduction==
The retrieve medication overview transaction is used by the PHR to retrieve a medication overview from the XIS.

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transaction group'''
! style="text-align:left;"| '''Transaction'''
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Retrieve Medication Overview(PULL)
|style="background-color: white;vertical-align:top;"|Retrieve medication overview request
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Request medication overview from the XIS
|-
|style="background-color: white;vertical-align:top;"|Retrieve medication overview response
|style="background-color: white;vertical-align:top;"|Healthcare professional (using a XIS)
|style="background-color: white;vertical-align:top;"|Serves medication overview to the PHR
|}

==Invocations==
===PHR: request message===
This message uses an extended operation on the RESTful API to obtain a medication overview from a XIS. This operation is used because the XIS needs to play an active role in formulating the content of the response.

====Trigger Events====
When the patient(PHR) wants to obtain the current medication overview, it issues a retrieve medication overview request message.

====Message Semantics====
The PHR executes a medication-overview operation with HTTP POST against the XIS's base endpoint as shown below.

<pre>
POST [base]/$medication-overview
</pre>

=====Expected Actions=====
The XIS shall process the operation to find or generate and return the current medication overview.

===XIS: response message===
The XIS returns a HTTP Status code appropriate to the processing of the operation as well as a Bundle of type 'collection', containing one List and one Patient resource along with other resources that represent the Medication Overview.

====Trigger Events====
The XIS completed processing of the retrieve medication overview request message.

====Message Semantics====
Based on the medication-overview operation processing results, the XIS will either return an error or success. When the XIS needs to report an error, it shall use HTTP error response codes and shall include a FHIR OperationOutcome resource with more details on the failure. If the request message is processed successfully, whether or not a Medication Overview is found or generated, the HTTP status code shall be 200.

The body of the response message shall be a Bundle resource of type "collection". The following section will elaborate on the content included.

If the XIS is sending warnings, the Bundle resource shall also contain a FHIR OperationOutcome resource that contains those warnings. The FHIR specification describes the relevant sections:
*[http://hl7.org/fhir/STU3/http.html RESTful API framework]
*[http://hl7.org/fhir/operations.html Operations]
*[http://hl7.org/fhir/STU3/bundle.html Bundle resource]
*[http://hl7.org/fhir/operationoutcome.html OperationOutcome resource]

=====Message content=====
The outcome of the [https://simplifier.net/NictizSTU3/Medication-Overview medication-overview operation] is the body of the medication overview request message. Successful processing of this operation should result in a Bundle recourse, containing one List and one Patient resource as entries along with all the resources that represent the current medication overview. These resources SHALL be referenced from the List resource. The clinical content of the medication overview is defined in the [https://informatiestandaarden.nictiz.nl/wiki/mp:V9.04_Ontwerp_medicatieproces#Medicatieoverzicht_en_afleidingsregels Medication Process specification]. The functional dataset of the medication overview can be found on [http://decor.nictiz.nl/medicatieproces/mp-html-20170829T141253/tr-2.16.840.1.113883.2.4.3.11.60.20.77.4.148-2016-11-08T103441.html decor.nictiz.nl].

<html>
<iframe width="750" frameborder="1" height="400" src=https://www.simplifier.net/embed/render?id=NictizSTU3/Medication-Overview frameborder="0" align="middle"></iframe>
</html>

The content in the response message SHALL be a valid instance of the following profiles. Clicking on the link will open the formal definition on Simplifier.net.

* '''Bundle profile:''' [https://simplifier.net/NictizSTU3/Bundle-MedicationOverview http://nictiz.nl/fhir/StructureDefinition/Bundle-MedicationOverview]
* '''List profile:''' [https://simplifier.net/NictizSTU3/List-MedicationOverview http://nictiz.nl/fhir/StructureDefinition/MedicationOverview]

The Bundle profile represents the structure of the retrieve medication overview response message. The List profile represents the actual medication overview. The List contains the medication overview metadata and references to all resources that constitute the medication overview. These resources are included in the Bundle as entries. The returned Bundle has at least one List and one Patient resource.

All returned resources to the PHR, including the Bundle and List, SHALL include their related profile canonical URL in the ''meta.profile'' element in order to show compliance. The resources in the response message SHALL be a valid instance of these profiles. In the table below, the ZIB's that constitute the clinical content of the Medication Overview and their respective profiles are listed.

'''Note''' that the medication building blocks are grouped per 'medication treatment' conform the [https://informatiestandaarden.nictiz.nl/wiki/mp:V9.04_Ontwerp_medicatieproces#Medicamenteuze_behandeling Medication Process specification]. Grouping SHALL be done by use of a 'medication treatment' identifier. This identifier shall be the same across different related medication resources that constitute a medication treatment. The [https://simplifier.net/NictizSTU3/zib-Medication-MedicationTreatment zib-Medication-MedicationTreatment extenstion] is added to all medication profiles and can be used for this grouping purpose.

{| class="wikitable"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|ZIB name NL||ZIB name EN||FHIR Resource||URL profile||Reference to section
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Patient
| #ZIB Patient|Patient
| Patient
| [https://simplifier.net/NictizSTU3/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_Patient | Patient]]
|-
| Zorgverlener
| HealthProfessional
| Practitioner
| [https://simplifier.net/NictizSTU3/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_HealthProfessional | HealthProfessional]]
|-
| Zorgaanbieder
| HealthcareProvider
| Organization
| [https://simplifier.net/NictizSTU3/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
| [[Bestand: Verwijzing.png| 20px]][[MedMij:V1.0_FHIR_HealthcareProvider | HealthcareProvider]]
|-
| Medicatiegebruik||MedicationUsage||MedicationStatement|| [https://simplifier.net/NictizSTU3/zib-MedicationUse http://nictiz.nl/fhir/StructureDefinition/zib-MedicationUse]|| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_MedicationUse | MedicationUse]]
|-
| Toedieningsafspraak||AdministrationAgreement||MedicationDispense|| [https://simplifier.net/NictizSTU3/zib-AdministrationAgreement http://nictiz.nl/fhir/StructureDefinition/zib-AdministrationAgreement]|| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_AdministrationAgreement | AdministrationAgreement]]
|-
| Medicatieafspraak||MedicationAgreement||MedicationRequest|| [https://simplifier.net/NictizSTU3/zib-MedicationAgreement http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAgreement] || [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_MedicationAgreement | MedicationAgreement]]
|-
| Product||Product||Medication|| [https://simplifier.net/NictizSTU3/zib-product http://nictiz.nl/fhir/StructureDefinition/zib-Product]|| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_Product | Product]]
|-
| GebruiksInstructie||InstructionsForUse||Dosage (datatype)|| [https://simplifier.net/NictizSTU3/zib-InstructionsForUse http://nictiz.nl/fhir/StructureDefinition/zib-InstructionsForUse]|| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_InstructionsForUse | InstructionsForUse]]
|-
|}

====Expected Actions====
The PHE processes the results according to application-defined rules. The PHR should be robust as the response may contain medication information resources as mentioned in the former section.

==Interactions, operations, search parameters==
===Interactions===
No interactions are needed for the retrieve medication overview transaction.

===Operations===
The retrieve medication overview medication operation is used for this transaction. The formal definition can be found here:
* [https://simplifier.net/NictizSTU3/Medication-Overview medication-overview]

===Search parameters===
The following search parameter type needs to be supported for this transaction.

Search parameter types:
* [http://hl7.org/fhir/STU3/search.html#token token]

=Use case: retrieve medication information=
{{FHIR-IG-Afsprakenstelsel-Note}}

==Introduction==
The Retrieve Medication Information transaction is used by the PHR to retrieve medication information from the XIS. The PHR can use this transaction to retrieve the wanted information by searching on specific medication building blocks.

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transaction group'''
! style="text-align:left;"| '''Transaction'''
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;" rowspan="3"|Retrieve Medication Information(PULL)
|style="background-color: white;vertical-align:top;"|Retrieve medication information request
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Request medication information from the XIS
|-
|style="background-color: white;vertical-align:top;"|Retrieve medication information response
|style="background-color: white;vertical-align:top;"|Healthcare professional (using a XIS)
|style="background-color: white;vertical-align:top;"|Serves medication information to the PHR
|}

==Invocations==
===PHR: request message===
This message uses the HTTP GET method parameterized query to obtain medication information from a XIS. Multiple different HTTP GET request messages may be needed to retrieve all medication information.

====Trigger Events====
When the patient(PHR) wants to obtain medication information matching various parameters, it issues a retrieve medication information request message.

====Message Semantics====
The PHR executes an HTTP GET against the XIS's medication FHIR endpoints. These endpoints can be one of the following:
* MedicationRequest
* MedicationAdministration
* MedicationDispense
* MedicationStatement

The search interaction is performed by an HTTP GET conform the [http://hl7.org/fhir/STU3/search.html FHIR search specification] as shown:

<pre>
GET [base]/[type]{?[parameters]{&_format=[mime-type]}}
</pre>

This URL is configurable by the PHR by configuring the query search parameters and search control parameters to modify the behavior of the XIS such as response format, or pagination. An example of a search for MedicationRequest resources:

<pre>
GET https://vonk.test-nictiz.nl/MedicationRequest?date=gt2010-10-01
</pre>

This search interaction will finds any MedicationRequest resources changed since 1-Oct 2010.

=====Including other resources in searchresults=====
The PHR may request that the XIS return resources related to the search results, in order to reduce the overall network delay of repeated retrievals of related resources. This is useful when the PHR is searching on a clinical resource, but for every such resource returned, the client will also need the subject (Patient resource) or prescriber (Practitioner resource) or medication that the clinical resource refers to. The client can use the _include parameter to indicate that the subject resources be included in the results. Example search:

<pre>
GET [base]/MedicationRequest?&category=http://snomed.info/sct|16076005&_include:MedicationRequest:medication
</pre>

This search interaction will find all MedicationRequest resources of the category MedicationAgreement and if present include the referenced Medication resource.

====Query Search Parameters====
The PHR may supply, and the XIS SHALL be capable of processing, all query parameters listed in the table below. The XIS may choose to support additional query parameters beyond the subset listed below. Any additional query parameters supported shall be supported according to the core FHIR specification. Such additional parameters are considered out of scope for this transaction.

{| class="wikitable"
! style="font-weight: bold;text-align:left;" | MP9 search parameters
! style="font-weight: bold;text-align:left;" | Description
! style="font-weight: bold;text-align:left;" | FHIR search parameter
! style="font-weight: bold;text-align:left;" | FHIR resource
|-
| Identification
| Search on identifier.
| identifier
| MedicationRequest, MedicationDispense, MedicationAdministration, MedicationStatement
|-
| Type
| Search on type of medication building block (HCIM).
| category '''*''' / '''**'''
| MedicationRequest, MedicationAdministration, MedicationDispense, MedicationStatement
|-
| ProductCode
| Search on medication code.
| code
| MedicationRequest, MedicationAdministration, MedicationDispense, MedicationStatement, Medication
|-
| UsePeriod
| Search on medication use in the past, present or future within the specified time period.
| periodofuse '''**'''
| MedicationDispense, MedicationRequest
|-
| DispensePeriod
| Returns all medication dispenses within the specific period.
| whenhandedover
| MedicationDispense
|}
'''*''' The FHIR profiles that represent the medication building blocks contain fixed code values in the ''.category'' elements to allow searching on specific medication building blocks. FHIR resources MedicationAdministration and MedicationDispense do not contain a 'category' search parameter in the FHIR specification. Custom search parameters are provided.

'''**''' The search parameter consists of a custom created FHIR search parameter not represented in the FHIR specification.

=====Custom Search Parameters=====

The follow custom search parameters are defined for this use case:

* https://simplifier.net/NictizSTU3/Medications-category
* https://simplifier.net/NictizSTU3/Medications-periodofuse

=====Search on fixed category code=====
To distinguish the ZIB medication building blocks between general medication resources, a fixed category coding has been added to the ZIB medication profiles. This fixed category code is solely used for indexing and retrieval of the ZIB building blocks. These category codings be found in the in the profiles at the .category element. The profiles are listed at the response message section below.

====Example Searches====

'''Identifier'''
<pre>1. https://vonk.test-nictiz.nl/MedicationRequest?identifier=http://example.nl/fhir/NamingSystem/MedicationRequest|999922448 </pre>
# Retrieves a MedicationRequest resource with the identifier 999922448.

'''Type'''
<pre>1. https://vonk.test-nictiz.nl/MedicationRequest
2. https://vonk.test-nictiz.nl/MedicationRequest?category=http://snomed.info/sct|16076005</pre>
# Retrieves all MedicationRequest resources.
# Retrieves all MedicationRequest resources that represent a ZIB MedicationAgreement.

'''ProductCode'''
<pre>1. https://vonk.test-nictiz.nl/MedicationRequest?medication.code=urn:oid:2.16.840.1.113883.2.4.4.8|13610554
2. https://vonk.test-nictiz.nl/MedicationRequest?include=Medication:medication&code=urn:oid:2.16.840.1.113883.2.4.4.8|13610554
3. https://vonk.test-nictiz.nl/MedicationRequest?category=http://snomed.info/sct|16076005&medication.code=urn:oid:2.16.840.1.113883.2.4.4.8|13610554</pre>
# Retrieves all MedicationRequest resources that have Carbasalaatcalcium Sandoz 600 30 as medication.
# Retrieves all MedicationRequest resources that have Carbasalaatcalcium Sandoz 600 30 as medication and includes the Medication resource in the search results.
# Retrieves all MedicationRequest resources that represent a ZIB MedicationAgreement and have Carbasalaatcalcium Sandoz 600 30 as medication

'''UsePeriod'''
<pre>1. https://vonk.test-nictiz.nl/MedicationRequest?periodofuse=ge2010-01-01
2. https://vonk.test-nictiz.nl/MedicationDispense?periodofuse=ge2010-01-01&periodofuse=le2011-12-31
3. https://vonk.test-nictiz.nl/MedicationRequest?category=http://snomed.info/sct|16076005&periodofuse=ge2010-01-01</pre>
# Retrieves all MedicationRequest resources that were in effect after 01-01-2010.
# Retrieves all MedicationDispense resources that were in effect within a 2 year period.
# Retrieves all MedicationRequest resources that represent a ZIB MedicationAgreement and were in effect after 01-01-2010.

'''DispensePeriod'''
<pre>1. https://vonk.test-nictiz.nl/MedicationDispense?whenhandedover=ge2010-01-01
2. https://vonk.test-nictiz.nl/MedicationDispense?whenhandedover=ge2010-01-01&whenhandedover=le2011-12-31
3. https://vonk.test-nictiz.nl/MedicationDispense?whenhandedover=ge2010-01-01&category=http://snomed.info/sct|373784005
</pre>
# Retrieves all MedicationDispense resources that were handed over after 01-01-2010.
# Retrieves all MedicationDispense resources that were handed over within a 2 year period.
# Retrieves all MedicationDispense resources that represent a ZIB Dispense and were handed over after 01-01-2010.

=====Expected Actions=====
The XIS shall process the query to discover the medication information that match the search parameters given.

===XIS: response message===
The XIS returns a HTTP Status code appropriate to the processing as well as a FHIR Bundle including the matching medication information.

====Trigger Events====
The XIS completed processing of the Retrieve medication information request message.

====Message Semantics====
Based on the query results, the XIS will either return an error or success. When the XIS needs to report an error, it SHALL use HTTP error response codes and SHOULD include a FHIR OperationOutcome resource with more details on the failure. If the request message is processed successfully, whether or not any medication resources are found, the HTTP status code SHALL be 200.

The response message SHALL be a Bundle resource of type "searchset" containing zero or more FHIR resources as entries. If the XIS is sending warnings, the Bundle resource SHALL also contain a FHIR OperationOutcome resource that contains those warnings. The FHIR specification describes the relevant sections:
*[http://hl7.org/fhir/STU3/http.html RESTful API framework]
*[http://hl7.org/fhir/STU3/search.html#errors Search errors]
*[http://hl7.org/fhir/STU3/bundle.html Bundle resource]
*[http://hl7.org/fhir/operationoutcome.html OperationOutcome resource]

=====Message resource content=====
The returned data to the PHR should conform to the medication ZIBs profiles. In the table below the medication ZIB's and their respective FHIR profiles are listed. The resources in the response message SHALL be a valid instance of these profiles. All resources SHALL include their related profile canonical URL in the ''meta.profile'' element in order to show compliance.

'''Note''' that the medication building blocks are grouped per 'medication treatment' conform the [https://informatiestandaarden.nictiz.nl/wiki/mp:V9.04_Ontwerp_medicatieproces#Medicamenteuze_behandeling Medication Process specification]. Grouping SHALL be done by use of a 'medication treatment' identifier. This identifier shall be the same across different related medication resources that constitute a medication treatment. The [https://simplifier.net/NictizSTU3/zib-Medication-MedicationTreatment zib-Medication-MedicationTreatment extenstion] is added to all medication profiles and can be used for this grouping purpose.

{| class="wikitable" width="1400px"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|ZIB name NL||ZIB name EN||FHIR Resource||URL profile||Reference to section
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Patient
| #ZIB Patient|Patient
| Patient
| [https://simplifier.net/NictizSTU3/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_Patient | Patient]]
|-
| Zorgverlener
| HealthProfessional
| Practitioner
| [https://simplifier.net/NictizSTU3/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_HealthProfessional | HealthProfessional]]
|-
| Zorgaanbieder
| HealthcareProvider
| Organization
| [https://simplifier.net/NictizSTU3/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
| [[Bestand: Verwijzing.png| 20px]][[MedMij:V1.0_FHIR_HealthcareProvider | HealthcareProvider]]
|-
| Medicatiegebruik||MedicationUsage||MedicationStatement|| [https://simplifier.net/NictizSTU3/zib-MedicationUse http://nictiz.nl/fhir/StructureDefinition/zib-MedicationUse]|| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_MedicationUse | MedicationUse]]
|-
| Medicatietoediening||MedicationAdministration||MedicationAdministration|| [https://simplifier.net/NictizSTU3/zib-MedicationAdministration http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAdministration] || [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_MedicationAdministration | MedicationAdministration]]
|-
| Toedieningsafspraak||AdministrationAgreement||MedicationDispense|| [https://simplifier.net/NictizSTU3/zib-AdministrationAgreement http://nictiz.nl/fhir/StructureDefinition/zib-AdministrationAgreement]|| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_AdministrationAgreement | AdministrationAgreement]]
|-
| Medicatieafspraak||MedicationAgreement||MedicationRequest|| [https://simplifier.net/NictizSTU3/zib-MedicationAgreement http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAgreement] || [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_MedicationAgreement | MedicationAgreement]]
|-
| Verstrekking||Dispense||MedicationDispense|| [https://simplifier.net/NictizSTU3/zib-Dispense http://nictiz.nl/fhir/StructureDefinition/zib-Dispense]|| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_Dispense | Dispense]]
|-
| Verstrekkingsverzoek||MedicationDispenseRequest||MedicationRequest|| [https://simplifier.net/NictizSTU3/zib-DispenseRequest http://nictiz.nl/fhir/StructureDefinition/zib-DispenseRequest]|| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_MedicationDispenseRequest | DispenseRequest]]
|-
| Product||Product||Medication|| [https://simplifier.net/NictizSTU3/zib-product http://nictiz.nl/fhir/StructureDefinition/zib-Product]|| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_Product | Product]]
|-
| GebruiksInstructie||InstructionsForUse||Dosage (datatype)|| [https://simplifier.net/NictizSTU3/zib-InstructionsForUse http://nictiz.nl/fhir/StructureDefinition/zib-InstructionsForUse]|| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_InstructionsForUse | InstructionsForUse]]
|-
|}

====Expected Actions====
The PHR shall process the results according to application-defined rules. The PHR should be robust as the response may contain medication information resources that match the query parameters.

==Interactions, operations, search parameters==
===Interactions===
The following logical interactions are needed for the retrieve medication information transaction:
* [http://hl7.org/fhir/STU3/http.html#search Search]

===Operations===
No operations are defined or needed for this transaction.

===Search parameters===
The following search parameter types and search result parameters need to be supported for this transaction.

Search parameter types:
* [http://hl7.org/fhir/STU3/search.html#token token]
* [http://hl7.org/fhir/STU3/search.html#date date]

Search result parameters:
* [http://hl7.org/fhir/STU3/search.html#include _include]

[[categorie:MedMij FHIR Use Cases]]

MedMij:V2018.02 FHIR BGZ

2018-03-29T15:56:04Z

Marten Smits:

{{#customtitle:MedMij FHIR use case BgZ}}
{{IssueBox|This is the FHIR specification of an older version of the BgZ - To view the current version of the specification publication, see here: https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.02_FHIR_BGZ_2017 .}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:BGZ_icoon.png |link=|links|90px|Use case BgZ|Patient Summary (BgZ)]]
<imagemap>Bestand:Leeswijzer-technisch-banner 03 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.02_OntwerpBGZ|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.02_FHIR_IG|Technisch]]
desc none
</imagemap>

__TOC__

==Introduction==
[[Bestand:Functioneel-02.png|link=MedMij:V2018.02_Ontwerpen |100px|rechts|Functional design|Go to functional design]]

The program ‘Registratie aan de bron’ (Data capture at the point of Care) has defined Health and Care Information models ([https://zibs.nl/wiki/HCIM_Mainpage HCIMs] (English) or [https://zibs.nl/wiki/ZIB_Hoofdpagina ZIBs] (Dutch)) for The Netherlands. Next to these HCIMs, the program ‘Registratie aan de bron’ also made a selection of these HCIMs into the so called ‘Basisgegevensset Zorg’ (Common Clinical Dataset, a Dutch version of a ‘patient summary’, further referred to as ‘BgZ’). The BgZ serves as a minimal healthcare dataset that is always appropriate for caregivers in order to provide continuity of care for a patient and can be seen as representation of a patient summary.

A total of 26 HCIMs constitute the [https://www.registratieaandebron.nl/pdf/Basisgegevensset_Zorg_v1_0.pdf BgZ version 1.0]. The BgZ makes a subselection of the information concepts within these 26 HCIMs or restricts the HCIMs to a certain category. For example, only include the general practitioner of the patient or only the last known value of 'X'. MedMij created FHIR profiles that represent these 26 HCIMs completely, if no existing and usable profiles were available. The profiles represent their entire respective HCIM, to make them applicable in a broader context than a patient summary or even the MedMij context. An overview of the profiles can be found at the [[MedMij:V1.0_FHIR_BGZ#List_of_StructureDefinitions|list of StructureDefinitions]].

The patient journey of [https://www.nictiz.nl/ehealth/MedMij Thomas van Beek], provides a patients context for exchanging a patient summary from a healthcare provider's system (XIS) to a personal health record (PHR). MedMij created a [https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2017.01_Ontwerpen functional design] of the BgZ use case. This use case consists of enabling a patient to view his own BgZ in a PHR. This page will elaborate further on the HL7 FHIR details needed to exchange the BgZ information using FHIR.

==Actors involved==
{| class="wikitable"
! colspan="2" style="text-align:left;" | Persons
! colspan="2" style="text-align:left;" | Systems
! colspan="2" style="text-align:left;" | FHIR Capability Statements
|-
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
|-
| Patient
| The user of a personal healthcare enviorment.
| PHR
| Personal health record
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/NictizSTU3/bgz-clientcapabilities CapabilityStatement: Client]
| BgZ client requirements
|-
| Healthcare professional
| The user of a XIS
| XIS
| Healthcare information system
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/NictizSTU3/bgz-servercapabilities CapabilityStatement: Server]
| BgZ server requirements
|}

==Boundaries and Relationships==
The BgZ use case has similarities and differences with other use cases such as Medication Process, Vital Signs and Lab Results. These use cases use the same HCIM based FHIR profiles for exchanging information. The BgZ use case covers practically all profiles included in the other use cases. However, the BgZ differs in scope of the actual health information content that should be exchanged. For example, the BgZ conveys only the last known lab result of each type while the Lab Results use case may cover all known information.

==List of invocations==
[[Bestand:Afsprakenstelsel-01.png|link=https://www.medmij.nl/afsprakenstelsel/|rechts |100px|Go to Afsprakenstelsel]]

This FHIR implementation guide assumes that the PHR system is able to make a connection to the XIS that contains the patients BgZ information. It does not provide information on finding the right XIS nor does it provide information about security. These infrastructure and interface specifications are described in the [https://www.medmij.nl/afsprakenstelsel/ 'Afsprakenstelsel'].

===Client - PHR===
The PHR system can request the BgZ using individual search interactions. The search interaction searches the current resources based on some filter criteria. The interaction can be performed by an HTTP GET or command as shown:

<code>GET [base]/[type]/{?[parameters]{&_format=[mime-type]}}</code>

The BgZ consists of multiple FHIR resources with certain constraints. To obtain the patients BgZ, the client can use multiple individual search operations based on specified search queries. The client may also bundle the search operations in a batch. The individual requests are discussed first, followed by the batch procedure.

====Individual resource requests====
The table below shows in the first four columns the BgZ sections, the HCIMs that constitute those sections and the specific content of the BgZ. The last column shows the FHIR search queries to obtain the BgZ information. These queries are based on StructureDefinitions listed in [[MedMij:V2018.02_FHIR_BGZ#List_of_StructureDefinitions| this section]].

Each query is performed in the context of a specific authenticated patient, for which an OAuth2 token has been retrieved using the Authentication mechanisms described in the [https://www.medmij.nl/afsprakenstelsel/ 'Afsprakenstelsel']. This token must be passed in each call in the HTTP header named “Authorization”. Each XIS Gateway is required to perform filtering based on the patient associated with the OAuth2 token received for the request, so that only the records associated with the authenticated patient are returned. Therefore, no search parameters should be passed for patient identification.

{| class="wikitable collapsible" width="100%" style="horizontal-align: right"
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | #
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | BgZ Section
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | HCIM EN
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | Content
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | Example Search URL
|-
| 1
| Patient information
| Patient
| BSN, birthdate, gender, deceasedindicator, contact details, and general practitioner (practitioner or organization)
| <pre>GET [base]/Patient?_include=Patient:general-practitioner</pre>
|-
| 2
| Payment details
| Payer
| Insurance information
| <pre>GET [base]/Coverage?_include=Coverage:payor:Patient&_include=Coverage:payor:Organization</pre>
|-
| rowspan="2" | 3
| rowspan="2" | Treatment Directives
| TreatmentDirective
| Known treatment directives
| <pre>GET [base]/Consent?category=http://snomed.info/sct|11291000146105</pre>
|-
| Advance directive
| Known advance directives
| <pre>GET [base]/Consent?category=http://snomed.info/sct|11341000146107</pre>
|-
| 4
| Contactperson
| Contact
| First relation/contact
| <pre style="font-style: italic;">see Patient</pre>
|-
| 5
| Functional status
| FunctionalOrMentalStatus
| Last known functional / mental status
| <pre>GET [base]/Observation$lastn?category=http://snomed.info/sct|118228005,http://snomed.info/sct|364644000</pre>
|-
| 6
| Problems
| Concern
| All known problems for the following categories: problem, condition, diagnosis, symptom, finding, complaint, functional limitation, complication.
| <pre>GET [base]/Condition?category:in=http://decor.nictiz.nl/fhir/ValueSet/2.16.840.1.113883.2.4.3.11.60.40.2.5.1.1--20150401000000</pre>
|-
| rowspan="6" | 8
| rowspan="6" | Social history
| MaritalStatus
| Current marital status
| <pre style="font-style: italic;">see Patient</pre>
|-
| LivingSituation
| Current living situation
| <pre>GET [base]/Observation/$lastn?code=http://snomed.info/sct|365508006</pre>
|-
| DrugUse
| All known drug use
| <pre>GET [base]/Observation?code=http://snomed.info/sct|228366006</pre>
|-
| AlcoholUse
| All known alcohol use
| <pre>GET [base]/Observation?code=http://snomed.info/sct|228273003</pre>
|-
| TobaccoUse
| All known tobacco use
| <pre>GET [base]/Observation?code=http://snomed.info/sct|365980008</pre>
|-
| NutritionAdvice
| All known current dietary recommendations
| <pre>GET [base]/NutritionOrder?status=active</pre>
|-
| rowspan="2" | 9
| rowspan="2" | Alerts
| Alert
| All known alerts
| <pre>GET [base]/Flag</pre>
|-
| AllergyIntolerance
| All known information regarding allergies
| <pre>GET [base]/AllergyIntolerance</pre>
|-
| rowspan="2" | 10
| rowspan="2" | Medication
| MedicationUse
| Current medication use
| <pre>GET [base]/MedicationStatement?status=active
&category=urn:oid:2.16.840.1.113883.2.4.3.11.60.20.77.5.3|6&_include:MedicationStatement:medication</pre>
|-
| MedicationAgreement
| Current prescriptions
| <pre>GET [base]/MedicationRequest?status=active
&category=http://snomed.info/sct|16076005&_include:MedicationRequest:medication</pre>
|-
| 11
| Medial aids
| MedicalAid
| All known medicalaids
| <pre>GET [base]/DeviceUseStatement?_include=DeviceUseStatement:device</pre>
|-
| 12
| Vaccinations
| Vaccination
| All known vaccinations
| <pre>GET [base]/Immunization?status=completed</pre>
|-
| rowspan="3" | 13
| rowspan="3" | Vital signs
| BloodPressure
| Last known bloodpressure
| <pre>GET [base]/Observation/$lastn?code=http://loinc.org|85354-9</pre>
|-
| BodyWeight
| Last known body weight
| <pre>GET [base]/Observation/$lastn?code=http://loinc.org|29463-7</pre>
|-
| BodyHeight
| Last known body height
| <pre>GET [base]/Observation/$lastn?code=http://loinc.org|8302-2,http://loinc.org|8306-3,http://loinc.org|8308-9</pre>
|-
| 14
| Results
| LaboratoryTestResult
| Last known laboratory results per type
| <pre>GET [base]/Observation/$lastn?category=http://snomed.info/sct|275711006&_include=Observation:related-target&_include=Observation:specimen</pre>
|-
| 15
| Procedures
| Procedure
| All surgical procedures
| <pre>GET [base]/Procedure?category=http://snomed.info/sct|365508006</pre>
|-
| 16
| Encounters
| Contact
| All hospital admissions (no outpatient contacts)
| <pre>GET [base]/Encounter?class=http://hl7.org/fhir/v3/ActCode|IMP,http://hl7.org/fhir/v3/ActCode|ACUTE,http://hl7.org/fhir/v3/ActCode|NONAC</pre>
|-
| rowspan="5" | 17
| rowspan="5" | Planned care
| rowspan="5" | PlannedCareActivity
| rowspan="5" | All known planned care activities
| <pre>GET [base]/ProcedureRequest?status=active</pre>
|-
| <pre>GET [base]/ImmunizationRecommendation</pre>
|-
| <pre>GET [base]/MedicationDispense?category=http://snomed.info/sct|422037009&status=in-progress,preparation</pre>
|-
| <pre>GET [base]/DeviceRequest?status=active</pre>
|-
| <pre>GET [base]/Appointment?status=booked,pending,proposed</pre>
|-
| 18
| General practitioner
| HealthProfessional
| General Practitioner of the patient
| <pre style="font-style: italic;">see Patient</pre>
|}

====Batch request====
A FHIR [http://hl7.org/fhir/bundle.html Bundle resource] can be used to group the individual resource requests of the BgZ. If a bundle is used to query the BgZ, the bundle SHALL be of type = "batch".

A batch (type = "batch") consists of a series of entries. Each entry element SHALL contain a request element. Each entry has the details of an HTTP operation that informs the system processing the batch what to do with the entry. The bundle with type = batch is a transaction that is intended to be processed by a server as a group of actions in contrary to a bundle with type = 'transaction' where the entire set of HTTP operations is intended to be processed by a server as an atomic commit.

A batch interaction is performed by an HTTP POST command as shown:

<code>POST [base] {?_format=[mime-type]}</code>

The content of the post submission is a Bundle with Bundle.type = batch. Each entry carries request details (Bundle.entry.request) that provides the HTTP details of the action in order to inform the system processing the batch or what to do for the entry (note: the request is optional, but SHOULD be present). Every bundle.entry retrieves a resource using a GET method and a specified url. The XML below demonstrates a batch of requests that can be send to a server. This example can also be found [http://hl7.org/fhir/bundle-request-simplesummary.xml.html here].

<pre>
<Bundle xmlns="http://hl7.org/fhir">
<id value="bundle-request-simplesummary"/>
<type value="batch"/>


<entry>
<request>
<method value="GET"/>
<url value="/Patient/example"/>
</request>
</entry>

<entry>
<request>
<method value="GET"/>
<url value="/Condition?patient=example"/>
</request>
</entry>

<entry>
<request>
<method value="GET"/>
<url value="/MedicationStatement?patient=example"/>
</request>
</entry>
</Bundle>
</pre>

====Example batch request====
A predefined BgZ bundle batch can be found here: https://simplifier.net/NictizSTU3/Bundle-bgz-without-patient-ID/~xml

As mentioned earlier, within MedMij each query is performed in the context of a specific authenticated patient. Therefore the search queries do not have to contain the patient ID. However, in a broader context these queries with the patient ID may be necessary. Another batch example that contains these example patient ID's in the URLs can be found here: https://simplifier.net/NictizSTU3/BGZ-bundle-batch/~xml.

===Server - XIS===
Important sections of the FHIR specification for a server in this use case are the [http://hl7.org/fhir/STU3/http.html#2.21.0 RESTful API section] the [http://hl7.org/fhir/STU3/search.html search section] and [http://hl7.org/fhir/STU3/operations.html operation section] (for the nlast operation).

====Response on individual resource requests====
If the search succeeds, the server SHALL return a 200 OK HTTP status code and the return content SHALL be a Bundle with type = searchset containing the results of the search as a collection of zero or more resources in a defined order. The result collection can be long, so servers may use paging. If they do, they SHALL use the method described below (adapted from RFC 5005 (Feed Paging and Archiving ) for breaking the collection into pages if appropriate. The server MAY also return an [http://hl7.org/fhir/operationoutcome.html OperationOutcome resource] within the searchset Bundle entries that contains additional information about the search; if one is sent it SHALL NOT include any issues with a fatal or error severity, and it SHALL be marked with a Bundle.entry.search.mode of outcome.

In order to allow the client to be confident about what search parameters were used as criteria by the server, the server SHALL return the parameters that were actually used to process the search. Applications processing search results SHALL check these returned values where necessary. For example, if the server did not support some of the filters specified in the search, a client might manually apply those filters to the retrieved result set, display a warning message to the user or take some other action.

In the case of a RESTful search, these parameters are encoded in the self link in the bundle that is returned:
<pre>
<link>
<relation value="self"/>
<url value="http://example.org/Patient?identifier=[Patient-ID]/>
</link>
</pre>

Link to the relevant FHIR specification: http://hl7.org/fhir/STU3/http.html#search

====Response for a batch request====
For a batch the response the server SHALL return a Bundle with type set to batch-response that contains one entry for each entry in the request, in the same order, with the outcome of processing the entry. For the BgZ bundle batch, the response is a bundle of type = batch-response with multiple entries containing bundles of type = searchset that correspond to the individual search queries.

A client may use the returned Bundle to track the outcomes of processing the entry, and the identities assigned to the resources by the server. Each entry element SHALL contain a response element which details the outcome of processing the entry - the HTTP status code, and the location and ETag header values, which are used for identifying and versioning the resources. In addition, a resource may be included in the entry, as specified by the Prefer header.

Link to relevant FHIR specification: http://hl7.org/fhir/STU3/http.html#transaction-response

====Handling errors====
If the search fails (cannot be executed, not that there is no matches), the return value is a status code 4xx or 5xx with an OperationOutcome. A HTTP status code of 403 signifies that the server refused to perform the search, while other 4xx and 5xx codes signify that some sort of error has occurred. When the search fails, a server SHOULD return an OperationOutcome detailing the cause of the failure. Note: An empty search result is not a failure.

In some cases, parameters may cause an error. For instance:

* A parameter may refer to a non-existent resource e.g. <code>GET [base]/Observation?subject=101</code>, where "101" does not exist
* A parameter may refer to an unknown code e.g. <code>GET [base]/Observation?code=loinc|1234-1</code>, where the LOINC code "1234-1" is not known to the server
* A parameter may refer to a time that is out of scope e.g. <code>GET [base]/Condition?onset=le1995</code>, where the system only has data going back to 2001
* A parameter may use an illegal or unacceptable modifier e.g. <code>GET [base]/Condition?onset:text=1995</code>, where the modifier cannot be processed by the server
* A data time parameter may have incorrect format e.g. <code>GET [base]/Condition?onset=23%20May%202009</code>
* A parameter may be unknown or unsupported
Where the content of the parameter is syntactically incorrect, servers SHOULD return an error. However, where the issue is a logical condition (e.g. unknown subject or code), the server SHOULD process the search, including processing the parameter - with the result of returning an empty search set, since the parameter cannot be satisfied.

In such cases, the search process MAY include an OperationOutcome in the search set that contains additional hints and warnings about the search process. This is included in the search results as an entry with search mode = outcome. Clients can use this information to improve future searches.

Common HTTP Status codes returned on FHIR-related errors (in addition to normal HTTP errors related to security, header and content type negotiation issues):

* 400 Bad Request - search could not be processed or failed basic FHIR validation rules
* 401 Not Authorized - authorization is required for the interaction that was attempted
* 404 Not Found - resource type not supported, or not a FHIR end-point

Link to relevant FHIR specification: http://hl7.org/fhir/STU3/search.html#errors

====Example batch response====
An example of a batch response can be found here: https://simplifier.net/NictizSTU3/batch-response/~xml.

The batch-response is a bundle that contains bundles of the type = searchset in the entries. These bundles of type = searchset represent the individual queries in the bundle that is posted to the server. Please note that this example does not contain actual search results. There is no patient with the identifier '123456789' on the server. Therefore all the returned bundles are empty.

==Interactions, operations, search parameters==

===Interactions===

The following logical interactions are needed for the BgZ use case:
* [http://hl7.org/fhir/STU3/http.html#search Search]
* [http://hl7.org/fhir/STU3/http.html#transaction Batch/Transaction]

===Operations===
The following [http://hl7.org/fhir/STU3/operations.html operation] is needed to support this use case.
* [http://hl7.org/fhir/STU3/observation-operations.html#lastn Last N Observations Query]

The lastn query meets the common need for searching for the most recent or last n=number of observations for a subject. For example, retrieving the last 5 temperatures for a patient to view trends or fetching the most recent laboratory results or vitals signs. The link will provide more detailed information and examples regarding this operation.

===Search parameters===
The following search parameter types and search result parameters need to be supported for this use case.

Search parameter types:
* [http://hl7.org/fhir/STU3/search.html#token token]
** Including modifier 'in'
* [http://hl7.org/fhir/STU3/search.html#reference reference]

Search result parameters:
* [http://hl7.org/fhir/STU3/search.html#include _include]
* [http://hl7.org/fhir/STU3/search.html#include _revinclude]

==List of StructureDefinitions==
The profiles represent their entire respective HCIM, to make them applicable in a broader context than the exchange of BgZ or a MedMij context. An example for reuse of existing profiles are those of the patient administration resources and vital signs.

{| class="wikitable" style="horizontal-align: right"
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | Section
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:100px" | ZIB NL
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:100px" | HCIM EN
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:100px" | FHIR Resource
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:400px" | URL Profile
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:100px" | Reference to section
|-
| 01
| Patient
| #ZIB Patient|Patient
| Patient
| [https://simplifier.net/NictizSTU3/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_Patient | Patient]]
|-
| rowspan="3" |02
| rowspan="3" | Betaler
| rowspan="3" | Payer
| Coverage
| [https://simplifier.net/NictizSTU3/zib-Payer http://nictiz.nl/fhir/StructureDefinition/zib-Payer]
| [[Bestand: Verwijzing.png| 20px]][[MedMij:V1.0_FHIR_Payer | Payer]]
|-
| Organization
| [https://simplifier.net/NictizSTU3/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
| [[Bestand: Verwijzing.png| 20px]][[MedMij:V1.0_FHIR_HealthcareProvider | HealthcareProvider]]
|-
| Patient
| [https://simplifier.net/NictizSTU3/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_Patient| Patient]]
|-
| rowspan="2" |03
| BehandelAanwijzing
| TreatmentDirective
| Consent
| [https://simplifier.net/NictizSTU3/zib-TreatmentDirective http://nictiz.nl/fhir/StructureDefinition/zib-TreatmentDirective]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_TreatmentDirective | TreatmentDirective ]]
|-
| Wilsverklaring
| AdvanceDirective
| Consent
| [https://simplifier.net/NictizSTU3/zib-AdvanceDirective http://nictiz.nl/fhir/StructureDefinition/zib-AdvanceDirective]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_AdvanceDirective | AdvanceDirective]]
|-
| 04
| Contactpersoon
| Contact
| RelatedPerson
| [https://simplifier.net/NictizSTU3/nl-core-relatedperson http://fhir.nl/fhir/StructureDefinition/nl-core-relatedperson]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_RelatedPerson | RelatedPerson]]
|-
| 05
| Funct. OfMentaleStatus
| FunctionalOrMentalStatus
| Observation
| [https://simplifier.net/NictizSTU3/zib-FunctionalOrMentalStatus http://nictiz.nl/fhir/StructureDefinition/zib-FunctionalOrMentalStatus]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_FunctionalOrMentalStatus | FunctionalOrMentalStatus]]
|-
| 06
| OverdrachtConcern
| Concern
| Condition
| [https://simplifier.net/NictizSTU3/zib-Concern http://nictiz.nl/fhir/StructureDefinition/zib-Concern]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_Concern| Concern]]
|-
| rowspan="7" | 08
| BurgerlijkeStaat
| MaritalStatus
| Patient
| [https://simplifier.net/NictizSTU3/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_Patient| Patient]]
|-
| Woonsituatie
| LivingSituation
| Observation
| [https://simplifier.net/NictizSTU3/zib-LivingSituation http://nictiz.nl/fhir/StructureDefinition/zib-LivingSituation]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_LivingSituation| LivingSituation]]
|-
| DrugsGebruik
| DrugUse
| Observation
| [https://simplifier.net/NictizSTU3/zib-DrugUse http://nictiz.nl/fhir/StructureDefinition/zib-DrugUse]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_DrugUse| DrugUse]]
|-
| AlcoholGebruik
| AlcoholUse
| Observation
| [https://simplifier.net/NictizSTU3/zib-AlcoholUse http://nictiz.nl/fhir/StructureDefinition/zib-AlcoholUse]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_AlcoholUse | AlcoholUse]]
|-
| TabakGebruik
| TobaccoUse
| Observation
| [https://simplifier.net/NictizSTU3/zib-TobaccoUse http://nictiz.nl/fhir/StructureDefinition/zib-TobaccoUse]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_TobaccoUse |TobaccoUse ]]
|-
| Voedingsadvies
| NutritionAdvice
| NutritionOrder
| [https://simplifier.net/NictizSTU3/zib-NutritionAdvice http://nictiz.nl/fhir/StructureDefinition/zib-NutritionAdvice]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_NutritionAdvice | NutritionAdvice]]
|-
| Nationaliteit
| Nationality
| Patient
| [https://simplifier.net/NictizSTU3/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_Patient| Patient]]
|-
| rowspan="2" | 09
| Alert
| Alert
| Flag
| [https://simplifier.net/NictizSTU3/zib-Alert http://nictiz.nl/fhir/StructureDefinition/zib-Alert]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_Alert | Alert ]]
|-
| AllergieIntolerantie
| AllergyIntolerance
| AllergyIntolerance
| [https://simplifier.net/NictizSTU3/zib-AllergyIntolerance http://nictiz.nl/fhir/StructureDefinition/zib-AllergyIntolerance]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_AllergyIntolerance| AllergyIntolerance]]
|-
| rowspan="2" | 10
| rowspan="2" | MedicatieGebruik
| MedicationUse
| MedicationStatement
| [https://simplifier.net/NictizSTU3/zib-MedicationUse http://nictiz.nl/fhir/StructureDefinition/zib-MedicationUse]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_MedicationUse | MedicationUse]]
|-
| MedicationAgremeent
| MedicationRequest
| [https://simplifier.net/NictizSTU3/zib-MedicationAgreement http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAgreement]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_MedicationAgreement | MedicationAgreement]]
|-
| rowspan="2" | 11
| rowspan="2" | MedischHulpmiddel
| rowspan="2" | MedicalAid
| Device
| [https://simplifier.net/NictizSTU3/zib-MedicalAidProduct http://nictiz.nl/fhir/StructureDefinition/zib-MedicalAidProduct]
| rowspan="2" | [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_MedicalAid|MedicalAid]]
|-
| DeviceUseStatement
| [https://simplifier.net/NictizSTU3/zib-MedicalAid http://nictiz.nl/fhir/StructureDefinition/zib-MedicalAid]
|-
| rowspan="2" | 12
| rowspan="2" | Vaccinatie
| rowspan="2" | Vaccination
| Immunization
| [https://simplifier.net/NictizSTU3/zib-Vaccination http://nictiz.nl/fhir/StructureDefinition/zib-Vaccination]
| rowspan="2" | [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_Vaccination| Vaccination ]]
|-
| ImmunizationRecommendation
| [https://simplifier.net/NictizSTU3/zib-VaccinationRecommendation http://nictiz.nl/fhir/StructureDefinition/zib-VaccinationRecommendation]
|-
| rowspan="3" | 13
| Bloeddruk
| BloodPressure
| Observation
| [https://simplifier.net/NictizSTU3/zib-BloodPressure http://nictiz.nl/fhir/StructureDefinition/zib-BloodPressure]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_BloodPressure | BloodPressure]]
|-
| LichaamsGewicht
| BodyWeight
| Observation
| [https://simplifier.net/NictizSTU3/zib-BodyWeight http://nictiz.nl/fhir/StructureDefinition/zib-BodyWeight]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_BodyWeight | BodyWeight]]
|-
| LichaamsLengte
| BodyHeight
| Observation
| [https://simplifier.net/NictizSTU3/zib-BodyHeight http://nictiz.nl/fhir/StructureDefinition/zib-BodyHeight]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_BodyHeight | BodyHeight]]
|-
| rowspan="2" | 14
| rowspan="2" | LaboratoriumUitslag
| rowspan="2" | LaboratoryTestResult
| Observation
| [https://simplifier.net/NictizSTU3/zib-LaboratoryTestResult-Observation http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Observation]
| rowspan="2" | [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_LaboratoryTestResult| LaboratoryTestResult]]
|-
| Specimen
| [https://simplifier.net/NictizSTU3/zib-LaboratoryTestResult-Specimen http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Specimen]
|-
| 15
| Verrichting
| Procedure
| Procedure
| [https://simplifier.net/NictizSTU3/zib-Procedure http://nictiz.nl/fhir/StructureDefinition/zib-Procedure]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_Procedure | Procedure ]]
|-
| 16
| Contact
| Contact
| Encounter
| [https://simplifier.net/NictizSTU3/zib-Contact http://nictiz.nl/fhir/StructureDefinition/zib-Contact]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_Contact | Contact ]]
|-
| rowspan="5" | 17
| rowspan="5" | GeplandeZorgActiviteit
| rowspan="5" | PlannedCareActivity
| ProcedureRequest
| [https://simplifier.net/NictizSTU3/zib-ProcedureRequest http://nictiz.nl/fhir/StructureDefinition/zib-ProcedureRequest]
| rowspan="5" | [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_PlannedCareActivity | PlannedCareActivity]]
|-
| MedicationRequest
| [https://simplifier.net/NictizSTU3/zib-MedicationAgreement http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAgreement]
|-
| ImmunizationRecommendation
| [https://simplifier.net/NictizSTU3/zib-VaccinationRecommendation http://nictiz.nl/fhir/StructureDefinition/zib-VaccinationRecommendation]
|-
| DeviceRequest
| [https://simplifier.net/NictizSTU3/zib-MedicalAidRequest http://nictiz.nl/fhir/StructureDefinition/zib-MedicalAidRequest]
|-
| Appointment
| [https://simplifier.net/NictizSTU3/zib-Appointment http://nictiz.nl/fhir/StructureDefinition/zib-Appointment]
|-
| rowspan="4" | 18
| rowspan="2" | Zorgverlener
| rowspan="2" | HealthProfessional
| Practitioner
| [https://simplifier.net/NictizSTU3/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
| rowspan="2" | [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_HealthProfessional | HealthProfessional]]
|-
| PractitionerRole
| [https://simplifier.net/NictizSTU3/nl-core-practitionerrole http://fhir.nl/fhir/StructureDefinition/nl-core-practitionerrole]
|-
| Zorgaanbieder
| HealthcareProvider
| Organization
| [https://simplifier.net/NictizSTU3/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
| [[Bestand: Verwijzing.png| 20px]][[MedMij:V1.0_FHIR_HealthcareProvider | HealthcareProvider]]
|}

==Terminology, NamingSystems, Mappings==

===Terminology===
Relevant value sets can be found [https://simplifier.net/NictizSTU3/~resources?category=ValueSet here]. All resources can be downloaded in a .zip in XML or JSON format. In the .zip, the value sets are stored in the directory 'value sets'.

===NamingSystems===
Relevant NamingSystems can be found [https://simplifier.net/NictizSTU3/~resources?category=NamingSystem here].

===Mappings===
Relevant HCIM to FHIR value set mappings can be found [https://simplifier.net/NictizSTU3/~resources?category=ConceptMap here].
All profiles include HCIM mappings. HCIM concepts are mapped in the corresponding FHIR elements using the HCIMs concept id. The top of the StructureDefinition contains meta information regarding the HCIM mapping, such as the name and uri of the HCIM. In the StructureDefinition elements the corresponding HCIM ID is given including the mapping meta information id. This is illustrated in the following example.

<pre>
<StructureDefinition>
<id value="nl-core-patient" />
.....
<mapping>
<identity value="hcim-patient-v3.1-2017EN"/>
<uri value="https://zibs.nl/wiki/Patient-v3.1(2017EN)"/>
<name value="HCIM Patient-v3.1(2017EN)"/>
</mapping>
.....
<element id="Patient.name">
<path value="Patient.name" />
<short value="NameInformation" />
<alias value="Naamgegevens" />
<type>
<code value="HumanName" />
<profile value="http://fhir.nl/fhir/StructureDefinition/nl-core-humanname" />
</type>
<mapping>
<identity value="hcim-patient-v3.1-2017EN"/>
<map value="NL-CM:0.1.6"/>
</mapping>
</element>
.....
</StructureDefinition>
</pre>

[[categorie:MedMij FHIR Use Cases]]

MedMij:V2018.02 FHIR BGZ 2017

2018-03-29T15:55:37Z

Marten Smits: /* Individual resource requests */

{{#customtitle:MedMij FHIR use case BgZ 2017}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:BGZ_icoon.png |link=|links|90px|Use case BgZ 2017|Patient Summary (BgZ)]]
<imagemap>Bestand:Leeswijzer-technisch-banner 03 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.02_OntwerpBGZ_2017|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.02_FHIR_IG|Technisch]]
desc none
</imagemap>

__TOC__

==Introduction==
[[Bestand:Functioneel-02.png|link=MedMij:V2018.02_Ontwerpen |100px|rechts|Functional design|Go to functional design]]

The program ‘Registratie aan de bron’ (Data capture at the point of Care) has defined Health and Care Information models ([https://zibs.nl/wiki/HCIM_Mainpage HCIMs] (English) or [https://zibs.nl/wiki/ZIB_Hoofdpagina ZIBs] (Dutch)) for The Netherlands. Next to these HCIMs, the program ‘Registratie aan de bron’ also made a selection of these HCIMs into the so called ‘Basisgegevensset Zorg’ (Common Clinical Dataset, a Dutch version of a ‘patient summary’, further referred to as ‘BgZ’). The BgZ serves as a minimal healthcare dataset that is always appropriate for caregivers in order to provide continuity of care for a patient and can be seen as representation of a patient summary.

A subselection of the published [https://zibs.nl/wiki/HCIM_Release_2017(EN) HCIMs release 2017] constitute the [https://www.registratieaandebron.nl/pdf/BgZ_specificatie_obv_zibs_2017_v1.0.pdf BgZ 2017]. The BgZ makes a subselection of the information concepts within the HCIMs or restricts the HCIMs to a certain category. For example, only include the general practitioner of the patient or only the last known value of 'X'. MedMij created FHIR profiles that represent these HCIMs completely, if no existing and usable profiles were available. The profiles represent their entire respective HCIM, to make them applicable in a broader context than a patient summary or even the MedMij context. An overview of the profiles can be found at the [[MedMij:V2018.02_FHIR_BGZ_2017#List_of_StructureDefinitions|list of StructureDefinitions]].

The patient journey of [https://www.nictiz.nl/ehealth/MedMij Thomas van Beek], provides a patients context for exchanging a patient summary from a healthcare provider's system (XIS) to a personal health record (PHR). MedMij created a [https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.02_Ontwerpen functional design] of the BgZ use case. This use case consists of enabling a patient to view his own BgZ in a PHR. This page will elaborate further on the HL7 FHIR details needed to exchange the BgZ information using FHIR.

==Actors involved==
{| class="wikitable"
! colspan="2" style="text-align:left;" | Persons
! colspan="2" style="text-align:left;" | Systems
|-
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
|-
| Patient
| The user of a personal healthcare enviorment.
| PHR
| Personal health record
|-
| Healthcare professional
| The user of a XIS
| XIS
| Healthcare information system
|}

==Boundaries and Relationships==
The BgZ 2017 use case follows the BgZ 1.0 use case. The diffence between the two are the underlying HCIMs, which have been upgraded from release 2015 to release 2017.

Release notes can be found here:https://github.com/Nictiz/Nictiz-STU3-Zib2017/raw/master/ReleaseNotes%20FHIR%20profielen%20ZIB2017.pdf

The BgZ use case has similarities and differences with other use cases such as Medication Process, Vital Signs and Lab Results. These use cases use the same HCIM based FHIR profiles for exchanging information. The BgZ use case covers practically all profiles included in the other use cases. However, the BgZ differs in scope of the actual health information content that should be exchanged. For example, the BgZ conveys only the last known lab result of each type while the Lab Results use case may cover all known information.

==List of invocations==
[[Bestand:Afsprakenstelsel-01.png|link=https://www.medmij.nl/afsprakenstelsel/|rechts |100px|Go to Afsprakenstelsel]]

This FHIR implementation guide assumes that the PHR system is able to make a connection to the XIS that contains the patients BgZ information. It does not provide information on finding the right XIS nor does it provide information about security. These infrastructure and interface specifications are described in the [https://www.medmij.nl/afsprakenstelsel/ 'Afsprakenstelsel'].

===Client - PHR===
The PHR system can request the BgZ using individual search interactions. The search interaction searches the current resources based on some filter criteria. The interaction can be performed by an HTTP GET or command as shown:

<code>GET [base]/[type]/{?[parameters]{&_format=[mime-type]}}</code>

The BgZ consists of multiple FHIR resources with certain constraints. To obtain the patients BgZ, the client can use multiple individual search operations based on specified search queries. The client may also bundle the search operations in a batch. The individual requests are discussed first, followed by the batch procedure.

====Individual resource requests====
The table below shows in the first four columns the BgZ sections, the HCIMs that constitute those sections and the specific content of the BgZ. The last column shows the FHIR search queries to obtain the BgZ information. These queries are based on StructureDefinitions listed in [[MedMij:V2018.02_FHIR_BGZ_2017#List_of_StructureDefinitions| this section]].

Each query is performed in the context of a specific authenticated patient, for which an OAuth2 token has been retrieved using the Authentication mechanisms described in the [https://www.medmij.nl/afsprakenstelsel/ 'Afsprakenstelsel']. This token must be passed in each call in the HTTP header named “Authorization”. Each XIS Gateway is required to perform filtering based on the patient associated with the OAuth2 token received for the request, so that only the records associated with the authenticated patient are returned. Therefore, no search parameters should be passed for patient identification.
{| class="wikitable collapsible" width="100%" style="horizontal-align: right"
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | #
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | BgZ Section
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | HCIM EN
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | Content
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | Example Search URL
|-
| 1
| Patient information
| Patient
| BSN, birthdate, gender, deceasedindicator, contact details, marital status, and general practitioner (practitioner or organization)
| <pre>GET [base]/Patient?_include=Patient:general-practitioner</pre>
|-
| 2
| Payment details
| Payer
| Insurance information
| <pre>GET [base]/Coverage?_include=Coverage:payor:Patient&_include=Coverage:payor:Organization</pre>
|-
| rowspan="2" | 3
| rowspan="2" | Treatment Directives
| TreatmentDirective
| Known treatment directives
| <pre>GET [base]/Consent?category=http://snomed.info/sct|11291000146105</pre>
|-
| Advance directive
| Known advance directives
| <pre>GET [base]/Consent?category=http://snomed.info/sct|11341000146107</pre>
|-
| 4
| Contactperson
| Contact
| First relation/contact
| <pre style="font-style: italic;">see Patient</pre>
|-
| 5
| Functional status
| FunctionalOrMentalStatus
| Last known functional / mental status
| <pre>GET [base]/Observation$lastn?category=http://snomed.info/sct|118228005,http://snomed.info/sct|364644000</pre>
|-
| 6
| Problems
| Concern
| All known problems.
| <pre>GET [base]/Condition</pre>
|-
| rowspan="5" | 7
| rowspan="5" | Social history
| LivingSituation
| Current living situation
| <pre>GET [base]/Observation/$lastn?code=http://snomed.info/sct|365508006</pre>
|-
| DrugUse
| All known drug use
| <pre>GET [base]/Observation?code=http://snomed.info/sct|228366006</pre>
|-
| AlcoholUse
| All known alcohol use
| <pre>GET [base]/Observation?code=http://snomed.info/sct|228273003</pre>
|-
| TobaccoUse
| All known tobacco use
| <pre>GET [base]/Observation?code=http://snomed.info/sct|365980008</pre>
|-
| NutritionAdvice
| All known current dietary recommendations
| <pre>GET [base]/NutritionOrder?status=active</pre>
|-
| 8
| Alerts
| Alert
| All known alerts
| <pre>GET [base]/Flag</pre>
|-
| 9
| Allergies
| AllergyIntolerance
| All known information regarding allergies
| <pre>GET [base]/AllergyIntolerance</pre>
|-
| rowspan="3" | 10
| rowspan="3" | Medication
| MedicationUse
| Known medication use
| <pre>GET [base]/MedicationStatement?category=urn:oid:2.16.840.1.113883.2.4.3.11.60.20.77.5.3|6&_include:MedicationStatement:medication</pre>
|-
| MedicationAgreement
| Known medication agreements
| <pre>GET [base]/MedicationRequest?category=http://snomed.info/sct|16076005&_include:MedicationRequest:medication</pre>
|-
| AdministrationAgreement
| Known administration agreements
| <pre>GET [base]/MedicationDispense?category=http://snomed.info/sct|422037009&_include:MedicationDispense:medication</pre>
|-
| 11
| Medial aids
| MedicalAid
| All known medicalaids
| <pre>GET [base]/DeviceUseStatement?_include=DeviceUseStatement:device</pre>
|-
| 12
| Vaccinations
| Vaccination
| All known vaccinations
| <pre>GET [base]/Immunization?status=completed</pre>
|-
| rowspan="3" | 13
| rowspan="3" | Vital signs
| BloodPressure
| Last known bloodpressure
| <pre>GET [base]/Observation/$lastn?code=http://loinc.org|85354-9</pre>
|-
| BodyWeight
| Last known body weight
| <pre>GET [base]/Observation/$lastn?code=http://loinc.org|29463-7</pre>
|-
| BodyHeight
| Last known body height
| <pre>GET [base]/Observation/$lastn?code=http://loinc.org|8302-2,http://loinc.org|8306-3,http://loinc.org|8308-9</pre>
|-
| 14
| Results
| LaboratoryTestResult
| Last known laboratory results per type
| <pre>GET [base]/Observation/$lastn?category=http://snomed.info/sct|275711006&_include=Observation:related-target&_include=Observation:specimen</pre>
|-
| 15
| Procedures
| Procedure
| All surgical procedures
| <pre>GET [base]/Procedure?category=http://snomed.info/sct|365508006</pre>
|-
| 16
| Encounters
| Contact
| All hospital admissions (no outpatient contacts)
| <pre>GET [base]/Encounter?class=http://hl7.org/fhir/v3/ActCode|IMP,http://hl7.org/fhir/v3/ActCode|ACUTE,http://hl7.org/fhir/v3/ActCode|NONAC</pre>
|-
| rowspan="5" | 17
| rowspan="5" | Planned care
| rowspan="5" | PlannedCareActivity
| rowspan="5" | All known planned care activities
| <pre>GET [base]/ProcedureRequest?status=active</pre>
|-
| <pre>GET [base]/ImmunizationRecommendation</pre>
|-
| <pre>GET [base]/MedicationDispense?category=http://snomed.info/sct|422037009&status=in-progress,preparation</pre>
|-
| <pre>GET [base]/DeviceRequest?status=active</pre>
|-
| <pre>GET [base]/Appointment?status=booked,pending,proposed</pre>
|-
| 18
| General practitioner
| HealthProfessional
| General Practitioner of the patient
| <pre style="font-style: italic;">see Patient</pre>
|}

====Batch request====
A FHIR [http://hl7.org/fhir/stu3/bundle.html Bundle resource] can be used to group the individual resource requests of the BgZ. If a bundle is used to query the BgZ, the bundle SHALL be of type = "batch".

A batch (type = "batch") consists of a series of entries. Each entry element SHALL contain a request element. Each entry has the details of an HTTP operation that informs the system processing the batch what to do with the entry. The bundle with type = batch is a transaction that is intended to be processed by a server as a group of actions in contrary to a bundle with type = 'transaction' where the entire set of HTTP operations is intended to be processed by a server as an atomic commit.

A batch interaction is performed by an HTTP POST command as shown:

<code>POST [base] {?_format=[mime-type]}</code>

The content of the post submission is a Bundle with Bundle.type = batch. Each entry carries request details (Bundle.entry.request) that provides the HTTP details of the action in order to inform the system processing the batch or what to do for the entry (note: the request is optional, but SHOULD be present). Every bundle.entry retrieves a resource using a GET method and a specified url. The XML below demonstrates a batch of requests that can be send to a server. This example can also be found [http://hl7.org/fhir/stu3/bundle-request-simplesummary.xml.html here].

<pre>
<Bundle xmlns="http://hl7.org/fhir">
<id value="bundle-request-simplesummary"/>
<type value="batch"/>


<entry>
<request>
<method value="GET"/>
<url value="/Patient/example"/>
</request>
</entry>

<entry>
<request>
<method value="GET"/>
<url value="/Condition?patient=example"/>
</request>
</entry>

<entry>
<request>
<method value="GET"/>
<url value="/MedicationStatement?patient=example"/>
</request>
</entry>
</Bundle>
</pre>

====Example batch request====
A predefined BgZ bundle batch can be found here: https://simplifier.net/NictizSTU3-Zib2017/Bundle-bgz-without-patient-ID/~xml

As mentioned earlier, within MedMij each query is performed in the context of a specific authenticated patient. Therefore the search queries do not have to contain the patient ID. However, in a broader context these queries with the patient ID may be necessary. Another batch example that contains these example patient ID's in the URLs can be found here: https://simplifier.net/NictizSTU3-Zib2017/Bundle-bgz-with-patient-ID/~xml.

===Server - XIS===
Important sections of the FHIR specification for a server in this use case are the [http://hl7.org/fhir/STU3/http.html#2.21.0 RESTful API section] the [http://hl7.org/fhir/STU3/search.html search section] and [http://hl7.org/fhir/STU3/operations.html operation section] (for the nlast operation).

====Response on individual resource requests====
If the search succeeds, the server SHALL return a 200 OK HTTP status code and the return content SHALL be a Bundle with type = searchset containing the results of the search as a collection of zero or more resources in a defined order. The result collection can be long, so servers may use paging. If they do, they SHALL use the method described below (adapted from RFC 5005 (Feed Paging and Archiving ) for breaking the collection into pages if appropriate. The server MAY also return an [http://hl7.org/fhir/stu3/operationoutcome.html OperationOutcome resource] within the searchset Bundle entries that contains additional information about the search; if one is sent it SHALL NOT include any issues with a fatal or error severity, and it SHALL be marked with a Bundle.entry.search.mode of outcome.

In order to allow the client to be confident about what search parameters were used as criteria by the server, the server SHALL return the parameters that were actually used to process the search. Applications processing search results SHALL check these returned values where necessary. For example, if the server did not support some of the filters specified in the search, a client might manually apply those filters to the retrieved result set, display a warning message to the user or take some other action.

In the case of a RESTful search, these parameters are encoded in the self link in the bundle that is returned:
<pre>
<link>
<relation value="self"/>
<url value="http://example.org/Patient?identifier=[Patient-ID]/>
</link>
</pre>

Link to the relevant FHIR specification: http://hl7.org/fhir/STU3/http.html#search

====Response for a batch request====
For a batch the response the server SHALL return a Bundle with type set to batch-response that contains one entry for each entry in the request, in the same order, with the outcome of processing the entry. For the BgZ bundle batch, the response is a bundle of type = batch-response with multiple entries containing bundles of type = searchset that correspond to the individual search queries.

A client may use the returned Bundle to track the outcomes of processing the entry, and the identities assigned to the resources by the server. Each entry element SHALL contain a response element which details the outcome of processing the entry - the HTTP status code, and the location and ETag header values, which are used for identifying and versioning the resources. In addition, a resource may be included in the entry, as specified by the Prefer header.

Link to relevant FHIR specification: http://hl7.org/fhir/STU3/http.html#transaction-response

====Handling errors====
If the search fails (cannot be executed, not that there is no matches), the return value is a status code 4xx or 5xx with an OperationOutcome. A HTTP status code of 403 signifies that the server refused to perform the search, while other 4xx and 5xx codes signify that some sort of error has occurred. When the search fails, a server SHOULD return an OperationOutcome detailing the cause of the failure. Note: An empty search result is not a failure.

In some cases, parameters may cause an error. For instance:

* A parameter may refer to a non-existent resource e.g. <code>GET [base]/Observation?subject=101</code>, where "101" does not exist
* A parameter may refer to an unknown code e.g. <code>GET [base]/Observation?code=loinc|1234-1</code>, where the LOINC code "1234-1" is not known to the server
* A parameter may refer to a time that is out of scope e.g. <code>GET [base]/Condition?onset=le1995</code>, where the system only has data going back to 2001
* A parameter may use an illegal or unacceptable modifier e.g. <code>GET [base]/Condition?onset:text=1995</code>, where the modifier cannot be processed by the server
* A data time parameter may have incorrect format e.g. <code>GET [base]/Condition?onset=23%20May%202009</code>
* A parameter may be unknown or unsupported
Where the content of the parameter is syntactically incorrect, servers SHOULD return an error. However, where the issue is a logical condition (e.g. unknown subject or code), the server SHOULD process the search, including processing the parameter - with the result of returning an empty search set, since the parameter cannot be satisfied.

In such cases, the search process MAY include an OperationOutcome in the search set that contains additional hints and warnings about the search process. This is included in the search results as an entry with search mode = outcome. Clients can use this information to improve future searches.

Common HTTP Status codes returned on FHIR-related errors (in addition to normal HTTP errors related to security, header and content type negotiation issues):

* 400 Bad Request - search could not be processed or failed basic FHIR validation rules
* 401 Not Authorized - authorization is required for the interaction that was attempted
* 404 Not Found - resource type not supported, or not a FHIR end-point

Link to relevant FHIR specification: http://hl7.org/fhir/STU3/search.html#errors

====Example batch response====
The batch-response is a bundle that contains bundles of the type = searchset in the entries. These bundles of type = searchset represent the individual queries in the bundle that is posted to the server.

==Interactions, operations, search parameters==

===Interactions===

The following logical interactions are needed for the BgZ use case:
* [http://hl7.org/fhir/STU3/http.html#search Search]
* [http://hl7.org/fhir/STU3/http.html#transaction Batch/Transaction]

===Operations===
The following [http://hl7.org/fhir/STU3/operations.html operation] is needed to support this use case.
* [http://hl7.org/fhir/STU3/observation-operations.html#lastn Last N Observations Query]

The lastn query meets the common need for searching for the most recent or last n=number of observations for a subject. For example, retrieving the last 5 temperatures for a patient to view trends or fetching the most recent laboratory results or vitals signs. The link will provide more detailed information and examples regarding this operation.

===Search parameters===
The following search parameter types and search result parameters need to be supported for this use case.

Search parameter types:
* [http://hl7.org/fhir/STU3/search.html#token token]
** Including modifier 'in'
* [http://hl7.org/fhir/STU3/search.html#reference reference]

Search result parameters:
* [http://hl7.org/fhir/STU3/search.html#include _include]
* [http://hl7.org/fhir/STU3/search.html#include _revinclude]

==List of StructureDefinitions==
The profiles represent their entire respective HCIM, to make them applicable in a broader context than the exchange of BgZ or a MedMij context. An example for reuse of existing profiles are those of the patient administration resources and vital signs.

{| class="wikitable" style="horizontal-align: right"
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | Section
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:100px" | ZIB NL
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:100px" | HCIM EN
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:100px" | FHIR Resource
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:400px" | FHIR Profile
|-
| 01
| Patient
| #ZIB Patient|Patient
| Patient
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
|-
| rowspan="3" |02
| rowspan="3" | Betaler
| rowspan="3" | Payer
| Coverage
| [https://simplifier.net/NictizSTU3-Zib2017/zib-Payer http://nictiz.nl/fhir/StructureDefinition/zib-Payer]
|-
| Organization
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
|-
| Patient
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
|-
| rowspan="2" |03
| BehandelAanwijzing
| TreatmentDirective
| Consent
| [https://simplifier.net/NictizSTU3-Zib2017/zib-TreatmentDirective http://nictiz.nl/fhir/StructureDefinition/zib-TreatmentDirective]
|-
| Wilsverklaring
| AdvanceDirective
| Consent
| [https://simplifier.net/NictizSTU3-Zib2017/zib-AdvanceDirective http://nictiz.nl/fhir/StructureDefinition/zib-AdvanceDirective]
|-
| 04
| Contactpersoon
| Contact
| RelatedPerson
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-relatedperson http://fhir.nl/fhir/StructureDefinition/nl-core-relatedperson]
|-
| 05
| Funct. OfMentaleStatus
| FunctionalOrMentalStatus
| Observation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-FunctionalOrMentalStatus http://nictiz.nl/fhir/StructureDefinition/zib-FunctionalOrMentalStatus]
|-
| 06
| Probleem
| Problem
| Condition
| [https://simplifier.net/NictizSTU3-Zib2017/zib-Problem http://nictiz.nl/fhir/StructureDefinition/zib-Problem]
|-
| rowspan="5" | 07
| Woonsituatie
| LivingSituation
| Observation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-LivingSituation http://nictiz.nl/fhir/StructureDefinition/zib-LivingSituation]
|-
| DrugsGebruik
| DrugUse
| Observation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-DrugUse http://nictiz.nl/fhir/StructureDefinition/zib-DrugUse]
|-
| AlcoholGebruik
| AlcoholUse
| Observation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-AlcoholUse http://nictiz.nl/fhir/StructureDefinition/zib-AlcoholUse]
|-
| TabakGebruik
| TobaccoUse
| Observation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-TobaccoUse http://nictiz.nl/fhir/StructureDefinition/zib-TobaccoUse]
|-
| Voedingsadvies
| NutritionAdvice
| NutritionOrder
| [https://simplifier.net/NictizSTU3-Zib2017/zib-NutritionAdvice http://nictiz.nl/fhir/StructureDefinition/zib-NutritionAdvice]
|-
| 08
| Alert
| Alert
| Flag
| [https://simplifier.net/NictizSTU3-Zib2017/zib-Alert http://nictiz.nl/fhir/StructureDefinition/zib-Alert]
|-
| 09
| AllergieIntolerantie
| AllergyIntolerance
| AllergyIntolerance
| [https://simplifier.net/NictizSTU3-Zib2017/zib-AllergyIntolerance http://nictiz.nl/fhir/StructureDefinition/zib-AllergyIntolerance]
|-
| rowspan="3" | 10
| rowspan="3" | MedicatieGebruik
| MedicationUse
| MedicationStatement
| [https://simplifier.net/NictizSTU3/zib-MedicationUse http://nictiz.nl/fhir/StructureDefinition/zib-MedicationUse]
|-
| MedicationAgreement
| MedicationRequest
| [https://simplifier.net/NictizSTU3/zib-MedicationAgreement http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAgreement]
|-
| AdministrationAgreement
| MedicationDispense
| [https://simplifier.net/NictizSTU3/zib-AdministrationAgreement http://nictiz.nl/fhir/StructureDefinition/zib-AdministrationAgreement]
|-
| rowspan="2" | 11
| rowspan="2" | MedischHulpmiddel
| rowspan="2" | MedicalAid
| Device
| [https://simplifier.net/NictizSTU3-Zib2017/ZIB-MedicalDevice-Product http://nictiz.nl/fhir/StructureDefinition/zib-MedicalDeviceProduct]
|-
| DeviceUseStatement
| [https://simplifier.net/NictizSTU3-Zib2017/zib-MedicalDevice http://nictiz.nl/fhir/StructureDefinition/zib-MedicalDevice]
|-
| rowspan="2" | 12
| rowspan="2" | Vaccinatie
| rowspan="2" | Vaccination
| Immunization
| [https://simplifier.net/NictizSTU3-Zib2017/zib-Vaccination http://nictiz.nl/fhir/StructureDefinition/zib-Vaccination]
|-
| ImmunizationRecommendation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-VaccinationRecommendation http://nictiz.nl/fhir/StructureDefinition/zib-VaccinationRecommendation]
|-
| rowspan="3" | 13
| Bloeddruk
| BloodPressure
| Observation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-BloodPressure http://nictiz.nl/fhir/StructureDefinition/zib-BloodPressure]
|-
| LichaamsGewicht
| BodyWeight
| Observation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-BodyWeight http://nictiz.nl/fhir/StructureDefinition/zib-BodyWeight]
|-
| LichaamsLengte
| BodyHeight
| Observation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-BodyHeight http://nictiz.nl/fhir/StructureDefinition/zib-BodyHeight]
|-
| rowspan="2" | 14
| rowspan="2" | LaboratoriumUitslag
| rowspan="2" | LaboratoryTestResult
| Observation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-LaboratoryTestResult-Observation http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Observation]
|-
| Specimen
| [https://simplifier.net/NictizSTU3-Zib2017/zib-LaboratoryTestResult-Specimen http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Specimen]
|-
| 15
| Verrichting
| Procedure
| Procedure
| [https://simplifier.net/NictizSTU3-Zib2017/zib-Procedure http://nictiz.nl/fhir/StructureDefinition/zib-Procedure]
|-
| 16
| Contact
| Encounter
| Encounter
| [https://simplifier.net/NictizSTU3-Zib2017/zib-Encounter http://nictiz.nl/fhir/StructureDefinition/zib-Encounter]
|-
| rowspan="5" | 17
| rowspan="5" | GeplandeZorgActiviteit
| rowspan="5" | PlannedCareActivity
| ProcedureRequest
| [https://simplifier.net/NictizSTU3-Zib2017/zib-ProcedureRequest http://nictiz.nl/fhir/StructureDefinition/zib-ProcedureRequest]
|-
| MedicationRequest
| [https://simplifier.net/NictizSTU3/zib-MedicationAgreement http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAgreement]
|-
| ImmunizationRecommendation
| [https://simplifier.net/NictizSTU3-Zib2017/zib-VaccinationRecommendation http://nictiz.nl/fhir/StructureDefinition/zib-VaccinationRecommendation]
|-
| DeviceRequest
| [https://simplifier.net/NictizSTU3-Zib2017/zib-MedicalDevice-Request http://nictiz.nl/fhir/StructureDefinition/zib-MedicalDeviceRequest]
|-
| Appointment
| [https://simplifier.net/NictizSTU3/eAfspraken-Appointment http://nictiz.nl/fhir/StructureDefinition/eAfspraken-Appointment]
|-
| rowspan="3" | 18
| rowspan="2" | Zorgverlener
| rowspan="2" | HealthProfessional
| Practitioner
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
|-
| PractitionerRole
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-practitionerrole http://fhir.nl/fhir/StructureDefinition/nl-core-practitionerrole]
|-
| Zorgaanbieder
| HealthcareProvider
| Organization
| [https://simplifier.net/NictizSTU3-Zib2017/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
|}

==Terminology, NamingSystems, Mappings==

===Terminology===
Relevant value sets can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=ValueSet here]. All resources can be downloaded in a .zip in XML or JSON format. In the .zip, the value sets are stored in the directory 'value sets'.

===NamingSystems===
Relevant NamingSystems can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=NamingSystem here].

===Mappings===
Relevant HCIM to FHIR value set mappings can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=ConceptMap here].
All profiles include HCIM mappings. HCIM concepts are mapped in the corresponding FHIR elements using the HCIMs concept id. The top of the StructureDefinition contains meta information regarding the HCIM mapping, such as the name and uri of the HCIM. In the StructureDefinition elements the corresponding HCIM ID is given including the mapping meta information id. This is illustrated in the following example.

<pre>
<StructureDefinition>
<id value="nl-core-patient" />
.....
<mapping>
<identity value="hcim-patient-v3.1-2017EN"/>
<uri value="https://zibs.nl/wiki/Patient-v3.1(2017EN)"/>
<name value="HCIM Patient-v3.1(2017EN)"/>
</mapping>
.....
<element id="Patient.name">
<path value="Patient.name" />
<short value="NameInformation" />
<alias value="Naamgegevens" />
<type>
<code value="HumanName" />
<profile value="http://fhir.nl/fhir/StructureDefinition/nl-core-humanname" />
</type>
<mapping>
<identity value="hcim-patient-v3.1-2017EN"/>
<map value="NL-CM:0.1.6"/>
</mapping>
</element>
.....
</StructureDefinition>
</pre>

[[categorie:MedMij FHIR Use Cases]]

MedMij:V2018.02 FHIR LaboratoryResults

2018-03-29T15:28:06Z

Marten Smits:

{{#customtitle:MedMij FHIR use case LaboratoryResults}}

{{IssueBox|This page is a working page.}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:LabResults@2x.png|87px|links|Use case Medication|Medication process]]
<imagemap>Bestand:Leeswijzer-technisch-banner 03 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.02_OntwerpLabresult|Functioneel]]
circle 1787 230 212 [[MedMij:vdraft_FHIR_IG|Technisch]]
desc none
</imagemap>

=Introduction=
[[Bestand:Functioneel-02.png|link=MedMij:vdraft_Ontwerpen |100px|rechts|Functional design|Go to functional design]]

This page describes patient's use cases for the retrieval of laboratory results, in a personal health environment (PHE) context. Functional specifications are described at the [[MedMij:vdraft_Ontwerpen| functional design wiki page]]. The technical specification is described here. HL7 FHIR STU3 is used for this purpose.

Many laboratory result observations have important relationships to other observations and need to be grouped together. [http://hl7.org/fhir/observation.html#10.1.4.1 The FHIR specification] defines three structures to do this: DiagnosticReport and DiagnosticReport.result, Observation and Observation.component, and Observation and Observation.related. For the transactions of laboratory results retrieval the following two grouping structures are relevant.

====Observation====
Individual laboratory results are represented by Observation resources, such as one blood glucose value. The Observation resource can also be used as a structure for a panel or battery observation. Observation.related is used for any supporting result that can be interpreted and used on its own and has one or more different values for method, observation, performer, device, time, and/or error conditions. The top level observation specifies the grouping code in Observation.code, but typically does not have its own Observation.value, and the set of member observations are listed in the Observation.related element.

====DiagnosticReport====
In contrast to the Observation resource, the DiagnosticReport resource typically includes additional clinical context and some mix of atomic results, images, imaging reports, textual and coded interpretation, and formatted representations. Report conclusions can be expressed as a simple text blob, structured coded data or as an attached fully formatted report such as a PDF. The DiagnosticReport.code names the panel and serves as the grouping element, which is traditionally referred to as a "panel" or "battery" by laboratories. The DiagnosticReport.result element references the individual observations.

Both structures may exists in a XIS. Therefore, two transactions are defined to retrieve a patient's laboratory results. The transaction content either consists of a single and related laboratory results structure or a complete diagnostic report that adds more clinical meaning to the single and related laboratory results. The transactions:

* [[MedMij:vdraft_FHIR_LaboratoryResults#Use_case:_retrieve_laboratory_results| Retrieve laboratory results]]
* [[MedMij:vdraft_FHIR_LaboratoryResults#Use_case:_retrieve_laboratory_results_DiagnosticReport| Retrieve laboratory results DiagnosticReport]]

=Actors involved=
{| class="wikitable"
! colspan="2" style="text-align:left;" | Persons
! colspan="2" style="text-align:left;" | Systems
! colspan="2" style="text-align:left;" | FHIR Capability Statements
|-
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
|-
| Patient
| The user of a personal healthcare enviorment.
| PHR
| Personal health record
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/NictizSTU3/labresults-clientcapabilities CapabilityStatement: Client]
| LaboratoryResults process client requirements
|-
| Healthcare professional
| The user of a XIS
| XIS
| Healthcare information system
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/NictizSTU3/labresults-servercapabilities CapabilityStatement: Server]
| LaboratoryResults server requirements
|}

=Use case: retrieve laboratory results=
{{FHIR-IG-Afsprakenstelsel-Note}}

==Introduction==
The retrieve laboratory results transaction is used by the PHR to retrieve a laboratory results from a XIS.

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transaction group'''
! style="text-align:left;"| '''Transaction'''
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;" rowspan="3"|Retrieve Laboratory Results(PULL)
|style="background-color: white;vertical-align:top;"|Retrieve laboratory results request
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Request laboratory results from the XIS
|-
|style="background-color: white;vertical-align:top;"|Retrieve laboratory results response
|style="background-color: white;vertical-align:top;"|Healthcare professional (using a XIS)
|style="background-color: white;vertical-align:top;"|Serves laboratory results to the PHR
|}

==Invocations==
===PHR: request message===
The request message represents an HTTP GET parameterized query from the PHR to the XIS.

====Trigger Events====
When the patient(PHR) wants to obtain laboratory results, it issues a retrieve laboratory results request message.

====Message Semantics====
The PHR executes an HTTP GET conform to the FHIR [http://hl7.org/fhir/http.html RESTfull] and [http://hl7.org/fhir/search.html search] specification against the XIS's Observation endpoint. This search query URL is configurable by the PHE and has the following format.

<pre>
GET [base]/Observation?[parameters]{&_format=[mime-type]}
</pre>

=====Search Parameters=====
The PHR may supply, and the XIS shall be capable of processing, all query parameters listed below. These search parameters are a selection of the defined search parameters by the HL7 FHIR specification search parameters of [http://hl7.org/fhir/STU3/observation.html#search Observation].

{| class="wikitable"
! colspan="3" style="font-weight: bold; text-align:left;" | Observation
|-
| style="font-weight: bold;" | Name
| style="font-weight: bold;" | Type
| style="font-weight: bold;" | Description
|-
| date
| date
| Obtained date/time. If the obtained element is a period, a date that falls in the period.
|-
|category
|token
|The classification of the type of observation.
|}

=====Search on fixed category code=====
To distinguish the ZIB LaboratoryTestResults Observations between other Observation resources, such as ZIB DrugUse observations, a fixed category code has been added to the ZIB LaboratoryTestResults profile. This fixed category code is solely used for indexing and retrieval of the ZIB building blocks. For LaboratoryTestResult Observations this category code is SNOMED code '49581000146104' - Laboratory test finding (finding).

=====Including other resources in search results=====
The PHR may request that the XIS return resources related to the search results, in order to reduce the overall network delay of repeated retrievals of related resources. This is useful when the PHR is searching on a clinical resource, but for every such resource returned, the client will also need for example the subject (Patient resource) or performer (Organization / Practitioner resource) or Specimen resource that the clinical resource refers to. The client can use the _include parameter to indicate that the subject resources be included in the results. An example are shown below.

=====Example search URLs=====

<pre>
1. GET https://vonk.test-nictiz.nl/Observation?category=http://snomed.info/sct|49581000146104
2. GET https://vonk.test-nictiz.nl/Observation?category=http://snomed.info/sct|49581000146104&date=ge2010-01-01
3. GET https://vonk.test-nictiz.nl/Observation?category=http://snomed.info/sct|49581000146104&date=ge2010-01-01&date=le2011-12-31
4. GET https://vonk.test-nictiz.nl/Observation?include=Observation:specimen&category=http://snomed.info/sct|49581000146104date=ge2010-01-01&date=le2011-12-31</pre>

# Retrieves all ZIB LaboratoryTestResults Observation resources
# Retrieves all ZIB LaboratoryTestResults Observation resources that have an effective date greater than 01-01-2010.
# Retrieves all ZIB LaboratoryTestResults Observation resources that have an effective date within a 2 year period.
# Retrieves all ZIB LaboratoryTestResults Observation resources that have an effective date within a 2 year period and includes Specimen information in the searchresults.

=====Expected Actions=====
The XIS shall process the query to discover Observation resources that match the search parameters given.

===XIS: response message===
The XIS returns a HTTP Status code appropriate to the processing as well as a FHIR Bundle including the matching observation information.

====Trigger Events====
The XIS completed processing of the retrieve laboratory results request message.

====Message Semantics====
Based on the query results, the XIS will either return an error or success. When the XIS needs to report an error, it SHALL use HTTP error response codes and SHOULD include a FHIR OperationOutcome resource with more details on the failure. If the request message is processed successfully, whether or not any observation resources are found, the HTTP status code SHALL be 200.

The response message shall be a Bundle resource of type "searchset" containing zero or more FHIR resources as entries. If the XIS is sending warnings, the Bundle resource SHALL also contain a FHIR OperationOutcome resource that contains those warnings. The FHIR specification describes the relevant sections:
*[http://hl7.org/fhir/STU3/http.html RESTful API framework]
*[http://hl7.org/fhir/STU3/search.html#errors Search errors]
*[http://hl7.org/fhir/STU3/bundle.html Bundle resource]
*[http://hl7.org/fhir/operationoutcome.html OperationOutcome resource]

=====Message resource content=====
The returned data to the PHR should conform to the profiles listed in the table below. This table shows the relevant ZIBs and their related profiles. The resources in the response message SHALL be a valid instance of these profiles. All resources SHALL include their related profile canonical URL in the ''meta.profile'' element in order to show compliance.

{| class="wikitable" width="1400px"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|ZIB name NL||ZIB name EN||FHIR Resource||URL profile||Reference to section
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Patient
| #ZIB Patient|Patient
| Patient
| [https://simplifier.net/NictizSTU3/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_Patient | Patient]]
|-
| Zorgverlener
| HealthProfessional
| Practitioner
| [https://simplifier.net/NictizSTU3/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_HealthProfessional | HealthProfessional]]
|-
| Zorgaanbieder
| HealthcareProvider
| Organization
| [https://simplifier.net/NictizSTU3/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
| [[Bestand: Verwijzing.png| 20px]][[MedMij:V1.0_FHIR_HealthcareProvider | HealthcareProvider]]
|-
| rowspan="2" | LaboratoriumUitslag
| rowspan="2" | LaboratoryTestResult
| Observation
| [https://simplifier.net/NictizSTU3/zib-LaboratoryTestResult-Observation http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Observation]
| rowspan="2" | [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_LaboratoryTestResult| LaboratoryTestResult]]
|-
| Specimen
| [https://simplifier.net/NictizSTU3/zib-LaboratoryTestResult-Specimen http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Specimen]
|-
|}

====Expected Actions====
The PHR shall process the results according to application-defined rules. The PHR should be robust as the response may contain observation and specimen resources that match the query parameters.

==Interactions, operations, search parameters==
===Interactions===
The following logical interactions are needed for the retrieve laboratory results transaction:
* [http://hl7.org/fhir/STU3/http.html#search Search]

===Operations===
No operations are defined or needed for this transaction.

===Search parameters===
The following search parameter type needs to be supported for this transaction.

Search parameter types:
* [http://hl7.org/fhir/STU3/search.html#token token]
* [http://hl7.org/fhir/STU3/search.html#date date]

Search result parameters:
* [http://hl7.org/fhir/STU3/search.html#include _include]

==Examples==

=Use case: retrieve laboratory results DiagnosticReport=
{{FHIR-IG-Afsprakenstelsel-Note}}

==Introduction==
The retrieve laboratory diagnostic report transaction is used by the PHR to retrieve a laboratory results from a XIS.

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transaction group'''
! style="text-align:left;"| '''Transaction'''
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;" rowspan="3"|Retrieve Laboratory Results(PULL)
|style="background-color: white;vertical-align:top;"|Retrieve laboratory diagnostic report request
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Request laboratory diagnostic report from the XIS
|-
|style="background-color: white;vertical-align:top;"|Retrieve laboratory diagnostic report response
|style="background-color: white;vertical-align:top;"|Healthcare professional (using a XIS)
|style="background-color: white;vertical-align:top;"|Serves laboratory diagnostic report to the PHR
|}

==Invocations==
===PHR: request message===
The request message represents an HTTP GET parameterized query from the PHR to the XIS.

====Trigger Events====
When the patient(PHR) wants to obtain laboratory diagnostic report, it issues a retrieve laboratory diagnostic report request message.

====Message Semantics====
The PHR executes an HTTP GET conform to the FHIR [http://hl7.org/fhir/http.html RESTfull] and [http://hl7.org/fhir/search.html search] specification against the XIS's DiagnosticReport endpoint. This search query URL is configurable by the PHE and has the following format.

<pre>
GET [base]/DiagnosticReport?[parameters]{&_format=[mime-type]}
</pre>

=====Search Parameters=====
The PHR may supply, and the XIS shall be capable of processing, all query parameters listed below. These search parameters are a selection of the defined search parameters by the HL7 FHIR specification search parameters of [http://hl7.org/fhir/STU3/diagnosticreport.html#search DiagnosticReport].

{| class="wikitable"
! colspan="3" style="font-weight: bold; text-align:left;" | DiagnosticReport
|-
| style="font-weight: bold;" | Name
| style="font-weight: bold;" | Type
| style="font-weight: bold;" | Description
|-
| date
| date
| The clinically relevant time of the report.
|-
| category
| token
| Which diagnostic discipline/department created the report.
|}

=====Search on ZIB LaboratoryTestResult DiagnosticReport=====
A fixed category code has been added to the ZIB LaboratoryTestResults profile to distinguish the ZIB LaboratoryTestResult DiagnosticReports between other DiagnosticReport resources. This fixed category code is solely used for indexing and retrieval of the ZIB building blocks. For LaboratoryTestResult DiagnosticReport this category is SNOMED code '4241000179101' - Laboratory report (record artifact).

=====Including other resources in searchresults=====
The PHR may request that the XIS return resources related to the search results, in order to reduce the overall network delay of repeated retrievals of related resources. This is useful when the PHR is searching on a clinical resource, but for every such resource returned, the client will also need for example the subject (Patient resource) or performer (Organization / Practitioner resource) or the Observastion resource that the clinical resource refers to. The client can use the _include parameter to indicate that the subject resources be included in the results. An example are shown below.

=====Example search URLs=====
<pre>
1. GET https://vonk.test-nictiz.nl/DiagnosticReport?category=http://snomed.info/sct|4241000179101
2. GET https://vonk.test-nictiz.nl/DiagnosticReport?category=http://snomed.info/sct|4241000179101&date=ge2010-01-01
3. GET https://vonk.test-nictiz.nl/DiagnosticReport?category=http://snomed.info/sct|4241000179101&date=ge2010-01-01&date=le2011-12-31
4. GET https://vonk.test-nictiz.nl/DiagnosticReport?category=http://snomed.info/sct|4241000179101&include=DiagnosticReport:result&date=ge2010-01-01&date=le2011-12-31 </pre>

# Retrieves all ZIB LaboratoryTestResult DiagnosticReport resources
# Retrieves all ZIB LaboratoryTestResult DiagnosticReport resources that have an effective date greater than 01-01-2010.
# Retrieves all ZIB LaboratoryTestResult DiagnosticReport resources that have an effective date within a 2 year period.
# Retrieves all ZIB LaboratoryTestResult DiagnosticReport resources that have an effective date within a 2 year period and include the referenced Observation resources in the searchresults.

=====Expected Actions=====
The XIS shall process the query to discover DiagnosticReport resources that match the search parameters given.

===XIS: response message===
The XIS returns a HTTP Status code appropriate to the processing as well as a FHIR Bundle including the matching laboratory diagnostic report information.

====Trigger Events====
The XIS completed processing of the retrieve laboratory diagnostic report request message.

====Message Semantics====
Based on the query results, the XIS will either return an error or success. When the XIS needs to report an error, it SHALL use HTTP error response codes and SHOULD include a FHIR OperationOutcome resource with more details on the failure. If the request message is processed successfully, whether or not any DiagnosticReport resources are found, the HTTP status code SHALL be 200.

The response message shall be a Bundle resource of type "searchset" containing zero or more FHIR resources as entries. If the XIS is sending warnings, the Bundle resource SHALL also contain a FHIR OperationOutcome resource that contains those warnings. The FHIR specification describes the relevant sections:
*[http://hl7.org/fhir/STU3/http.html RESTful API framework]
*[http://hl7.org/fhir/STU3/search.html#errors Search errors]
*[http://hl7.org/fhir/STU3/bundle.html Bundle resource]
*[http://hl7.org/fhir/operationoutcome.html OperationOutcome resource]

=====Message resource content=====
The returned data to the PHR should conform to the profiles listed in the table below. This table shows the relevant ZIBs and their related profiles. The resources in the response message SHALL be a valid instance of these profiles. All resources SHALL include their related profile canonical URL in the ''meta.profile'' element in order to show compliance.

{| class="wikitable" width="1400px"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|ZIB name NL||ZIB name EN||FHIR Resource||URL profile||Reference to section
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Patient
| #ZIB Patient|Patient
| Patient
| [https://simplifier.net/NictizSTU3/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_Patient | Patient]]
|-
| Zorgverlener
| HealthProfessional
| Practitioner
| [https://simplifier.net/NictizSTU3/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_HealthProfessional | HealthProfessional]]
|-
| Zorgaanbieder
| HealthcareProvider
| Organization
| [https://simplifier.net/NictizSTU3/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
| [[Bestand: Verwijzing.png| 20px]][[MedMij:V1.0_FHIR_HealthcareProvider | HealthcareProvider]]
|-
| rowspan="3" | LaboratoriumUitslag
| rowspan="3" | LaboratoryTestResult
| DiagnosticReport
| [https://simplifier.net/NictizSTU3/zib-LaboratoryTestResult-DiagnosticReport http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-DiagnosticReport]
| rowspan="3" | [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_LaboratoryTestResult| LaboratoryTestResult]]
|-
| Observation
| [https://simplifier.net/NictizSTU3/zib-LaboratoryTestResult-Observation http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Observation]
|-
| Specimen
| [https://simplifier.net/NictizSTU3/zib-LaboratoryTestResult-Specimen http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Specimen]
|-
|}

====Expected Actions====
The PHR shall process the results according to application-defined rules. The PHR should be robust as the response may contain DiagnosticReport, Observation and Specimen resources that match the query parameters.

==Interactions, operations, search parameters==
===Interactions===
The following logical interactions are needed for the retrieve laboratory results transaction:
* [http://hl7.org/fhir/STU3/http.html#search Search]

===Operations===
No operations are defined or needed for this transaction.

===Search parameters===
The following search parameter type needs to be supported for this transaction.

Search parameter types:
* [http://hl7.org/fhir/STU3/search.html#token token]
* [http://hl7.org/fhir/STU3/search.html#date date]

Search result parameters:
* [http://hl7.org/fhir/STU3/search.html#include _include]

==Examples==

[[categorie:MedMij FHIR Use Cases]]

MedMij:V2018.02 FHIR LaboratoryResults

2018-03-29T15:27:39Z

Marten Smits:

{{#customtitle:MedMij FHIR use case LaboratoryResults}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:LabResults@2x.png|87px|links|Use case Medication|Medication process]]
<imagemap>Bestand:Leeswijzer-technisch-banner 03 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.02_OntwerpLabresult|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.02_FHIR_IG|Technisch]]
desc none
</imagemap>

=Introduction=
[[Bestand:Functioneel-02.png|link=MedMij:V2018.02_Ontwerpen |100px|rechts|Functional design|Go to functional design]]

This page describes patient's use cases for the retrieval of laboratory results, in a personal health environment (PHE) context. Functional specifications are described at the [[MedMij:V2018.02_Ontwerpen| functional design wiki page]]. The technical specification is described here. HL7 FHIR STU3 is used for this purpose.

Many laboratory result observations have important relationships to other observations and need to be grouped together. [http://hl7.org/fhir/observation.html#10.1.4.1 The FHIR specification] defines three structures to do this: DiagnosticReport and DiagnosticReport.result, Observation and Observation.component, and Observation and Observation.related. For the transactions of laboratory results retrieval the following two grouping structures are relevant.

====Observation====
Individual laboratory results are represented by Observation resources, such as one blood glucose value. The Observation resource can also be used as a structure for a panel or battery observation. Observation.related is used for any supporting result that can be interpreted and used on its own and has one or more different values for method, observation, performer, device, time, and/or error conditions. The top level observation specifies the grouping code in Observation.code, but typically does not have its own Observation.value, and the set of member observations are listed in the Observation.related element.

====DiagnosticReport====
In contrast to the Observation resource, the DiagnosticReport resource typically includes additional clinical context and some mix of atomic results, images, imaging reports, textual and coded interpretation, and formatted representations. Report conclusions can be expressed as a simple text blob, structured coded data or as an attached fully formatted report such as a PDF. The DiagnosticReport.code names the panel and serves as the grouping element, which is traditionally referred to as a "panel" or "battery" by laboratories. The DiagnosticReport.result element references the individual observations.

Both structures may exists in a XIS. Therefore, two transactions are defined to retrieve a patient's laboratory results. The transaction content either consists of a single and related laboratory results structure or a complete diagnostic report that adds more clinical meaning to the single and related laboratory results. The transactions:

* [[MedMij:V2018.02_FHIR_LaboratoryResults#Use_case:_retrieve_laboratory_results| Retrieve laboratory results]]
* [[MedMij:V2018.02_FHIR_LaboratoryResults#Use_case:_retrieve_laboratory_results_DiagnosticReport| Retrieve laboratory results DiagnosticReport]]

=Actors involved=
{| class="wikitable"
! colspan="2" style="text-align:left;" | Persons
! colspan="2" style="text-align:left;" | Systems
! colspan="2" style="text-align:left;" | FHIR Capability Statements
|-
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
|-
| Patient
| The user of a personal healthcare enviorment.
| PHR
| Personal health record
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/NictizSTU3/labresults-clientcapabilities CapabilityStatement: Client]
| LaboratoryResults process client requirements
|-
| Healthcare professional
| The user of a XIS
| XIS
| Healthcare information system
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/NictizSTU3/labresults-servercapabilities CapabilityStatement: Server]
| LaboratoryResults server requirements
|}

=Use case: retrieve laboratory results=
{{FHIR-IG-Afsprakenstelsel-Note}}

==Introduction==
The retrieve laboratory results transaction is used by the PHR to retrieve a laboratory results from a XIS.

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transaction group'''
! style="text-align:left;"| '''Transaction'''
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;" rowspan="3"|Retrieve Laboratory Results(PULL)
|style="background-color: white;vertical-align:top;"|Retrieve laboratory results request
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Request laboratory results from the XIS
|-
|style="background-color: white;vertical-align:top;"|Retrieve laboratory results response
|style="background-color: white;vertical-align:top;"|Healthcare professional (using a XIS)
|style="background-color: white;vertical-align:top;"|Serves laboratory results to the PHR
|}

==Invocations==
===PHR: request message===
The request message represents an HTTP GET parameterized query from the PHR to the XIS.

====Trigger Events====
When the patient(PHR) wants to obtain laboratory results, it issues a retrieve laboratory results request message.

====Message Semantics====
The PHR executes an HTTP GET conform to the FHIR [http://hl7.org/fhir/http.html RESTfull] and [http://hl7.org/fhir/search.html search] specification against the XIS's Observation endpoint. This search query URL is configurable by the PHE and has the following format.

<pre>
GET [base]/Observation?[parameters]{&_format=[mime-type]}
</pre>

=====Search Parameters=====
The PHR may supply, and the XIS shall be capable of processing, all query parameters listed below. These search parameters are a selection of the defined search parameters by the HL7 FHIR specification search parameters of [http://hl7.org/fhir/STU3/observation.html#search Observation].

{| class="wikitable"
! colspan="3" style="font-weight: bold; text-align:left;" | Observation
|-
| style="font-weight: bold;" | Name
| style="font-weight: bold;" | Type
| style="font-weight: bold;" | Description
|-
| date
| date
| Obtained date/time. If the obtained element is a period, a date that falls in the period.
|-
|category
|token
|The classification of the type of observation.
|}

=====Search on fixed category code=====
To distinguish the ZIB LaboratoryTestResults Observations between other Observation resources, such as ZIB DrugUse observations, a fixed category code has been added to the ZIB LaboratoryTestResults profile. This fixed category code is solely used for indexing and retrieval of the ZIB building blocks. For LaboratoryTestResult Observations this category code is SNOMED code '49581000146104' - Laboratory test finding (finding).

=====Including other resources in search results=====
The PHR may request that the XIS return resources related to the search results, in order to reduce the overall network delay of repeated retrievals of related resources. This is useful when the PHR is searching on a clinical resource, but for every such resource returned, the client will also need for example the subject (Patient resource) or performer (Organization / Practitioner resource) or Specimen resource that the clinical resource refers to. The client can use the _include parameter to indicate that the subject resources be included in the results. An example are shown below.

=====Example search URLs=====

<pre>
1. GET https://vonk.test-nictiz.nl/Observation?category=http://snomed.info/sct|49581000146104
2. GET https://vonk.test-nictiz.nl/Observation?category=http://snomed.info/sct|49581000146104&date=ge2010-01-01
3. GET https://vonk.test-nictiz.nl/Observation?category=http://snomed.info/sct|49581000146104&date=ge2010-01-01&date=le2011-12-31
4. GET https://vonk.test-nictiz.nl/Observation?include=Observation:specimen&category=http://snomed.info/sct|49581000146104date=ge2010-01-01&date=le2011-12-31</pre>

# Retrieves all ZIB LaboratoryTestResults Observation resources
# Retrieves all ZIB LaboratoryTestResults Observation resources that have an effective date greater than 01-01-2010.
# Retrieves all ZIB LaboratoryTestResults Observation resources that have an effective date within a 2 year period.
# Retrieves all ZIB LaboratoryTestResults Observation resources that have an effective date within a 2 year period and includes Specimen information in the searchresults.

=====Expected Actions=====
The XIS shall process the query to discover Observation resources that match the search parameters given.

===XIS: response message===
The XIS returns a HTTP Status code appropriate to the processing as well as a FHIR Bundle including the matching observation information.

====Trigger Events====
The XIS completed processing of the retrieve laboratory results request message.

====Message Semantics====
Based on the query results, the XIS will either return an error or success. When the XIS needs to report an error, it SHALL use HTTP error response codes and SHOULD include a FHIR OperationOutcome resource with more details on the failure. If the request message is processed successfully, whether or not any observation resources are found, the HTTP status code SHALL be 200.

The response message shall be a Bundle resource of type "searchset" containing zero or more FHIR resources as entries. If the XIS is sending warnings, the Bundle resource SHALL also contain a FHIR OperationOutcome resource that contains those warnings. The FHIR specification describes the relevant sections:
*[http://hl7.org/fhir/STU3/http.html RESTful API framework]
*[http://hl7.org/fhir/STU3/search.html#errors Search errors]
*[http://hl7.org/fhir/STU3/bundle.html Bundle resource]
*[http://hl7.org/fhir/operationoutcome.html OperationOutcome resource]

=====Message resource content=====
The returned data to the PHR should conform to the profiles listed in the table below. This table shows the relevant ZIBs and their related profiles. The resources in the response message SHALL be a valid instance of these profiles. All resources SHALL include their related profile canonical URL in the ''meta.profile'' element in order to show compliance.

{| class="wikitable" width="1400px"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|ZIB name NL||ZIB name EN||FHIR Resource||URL profile||Reference to section
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Patient
| #ZIB Patient|Patient
| Patient
| [https://simplifier.net/NictizSTU3/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_Patient | Patient]]
|-
| Zorgverlener
| HealthProfessional
| Practitioner
| [https://simplifier.net/NictizSTU3/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_HealthProfessional | HealthProfessional]]
|-
| Zorgaanbieder
| HealthcareProvider
| Organization
| [https://simplifier.net/NictizSTU3/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
| [[Bestand: Verwijzing.png| 20px]][[MedMij:V1.0_FHIR_HealthcareProvider | HealthcareProvider]]
|-
| rowspan="2" | LaboratoriumUitslag
| rowspan="2" | LaboratoryTestResult
| Observation
| [https://simplifier.net/NictizSTU3/zib-LaboratoryTestResult-Observation http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Observation]
| rowspan="2" | [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_LaboratoryTestResult| LaboratoryTestResult]]
|-
| Specimen
| [https://simplifier.net/NictizSTU3/zib-LaboratoryTestResult-Specimen http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Specimen]
|-
|}

====Expected Actions====
The PHR shall process the results according to application-defined rules. The PHR should be robust as the response may contain observation and specimen resources that match the query parameters.

==Interactions, operations, search parameters==
===Interactions===
The following logical interactions are needed for the retrieve laboratory results transaction:
* [http://hl7.org/fhir/STU3/http.html#search Search]

===Operations===
No operations are defined or needed for this transaction.

===Search parameters===
The following search parameter type needs to be supported for this transaction.

Search parameter types:
* [http://hl7.org/fhir/STU3/search.html#token token]
* [http://hl7.org/fhir/STU3/search.html#date date]

Search result parameters:
* [http://hl7.org/fhir/STU3/search.html#include _include]

==Examples==

=Use case: retrieve laboratory results DiagnosticReport=
{{FHIR-IG-Afsprakenstelsel-Note}}

==Introduction==
The retrieve laboratory diagnostic report transaction is used by the PHR to retrieve a laboratory results from a XIS.

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transaction group'''
! style="text-align:left;"| '''Transaction'''
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;" rowspan="3"|Retrieve Laboratory Results(PULL)
|style="background-color: white;vertical-align:top;"|Retrieve laboratory diagnostic report request
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Request laboratory diagnostic report from the XIS
|-
|style="background-color: white;vertical-align:top;"|Retrieve laboratory diagnostic report response
|style="background-color: white;vertical-align:top;"|Healthcare professional (using a XIS)
|style="background-color: white;vertical-align:top;"|Serves laboratory diagnostic report to the PHR
|}

==Invocations==
===PHR: request message===
The request message represents an HTTP GET parameterized query from the PHR to the XIS.

====Trigger Events====
When the patient(PHR) wants to obtain laboratory diagnostic report, it issues a retrieve laboratory diagnostic report request message.

====Message Semantics====
The PHR executes an HTTP GET conform to the FHIR [http://hl7.org/fhir/http.html RESTfull] and [http://hl7.org/fhir/search.html search] specification against the XIS's DiagnosticReport endpoint. This search query URL is configurable by the PHE and has the following format.

<pre>
GET [base]/DiagnosticReport?[parameters]{&_format=[mime-type]}
</pre>

=====Search Parameters=====
The PHR may supply, and the XIS shall be capable of processing, all query parameters listed below. These search parameters are a selection of the defined search parameters by the HL7 FHIR specification search parameters of [http://hl7.org/fhir/STU3/diagnosticreport.html#search DiagnosticReport].

{| class="wikitable"
! colspan="3" style="font-weight: bold; text-align:left;" | DiagnosticReport
|-
| style="font-weight: bold;" | Name
| style="font-weight: bold;" | Type
| style="font-weight: bold;" | Description
|-
| date
| date
| The clinically relevant time of the report.
|-
| category
| token
| Which diagnostic discipline/department created the report.
|}

=====Search on ZIB LaboratoryTestResult DiagnosticReport=====
A fixed category code has been added to the ZIB LaboratoryTestResults profile to distinguish the ZIB LaboratoryTestResult DiagnosticReports between other DiagnosticReport resources. This fixed category code is solely used for indexing and retrieval of the ZIB building blocks. For LaboratoryTestResult DiagnosticReport this category is SNOMED code '4241000179101' - Laboratory report (record artifact).

=====Including other resources in searchresults=====
The PHR may request that the XIS return resources related to the search results, in order to reduce the overall network delay of repeated retrievals of related resources. This is useful when the PHR is searching on a clinical resource, but for every such resource returned, the client will also need for example the subject (Patient resource) or performer (Organization / Practitioner resource) or the Observastion resource that the clinical resource refers to. The client can use the _include parameter to indicate that the subject resources be included in the results. An example are shown below.

=====Example search URLs=====
<pre>
1. GET https://vonk.test-nictiz.nl/DiagnosticReport?category=http://snomed.info/sct|4241000179101
2. GET https://vonk.test-nictiz.nl/DiagnosticReport?category=http://snomed.info/sct|4241000179101&date=ge2010-01-01
3. GET https://vonk.test-nictiz.nl/DiagnosticReport?category=http://snomed.info/sct|4241000179101&date=ge2010-01-01&date=le2011-12-31
4. GET https://vonk.test-nictiz.nl/DiagnosticReport?category=http://snomed.info/sct|4241000179101&include=DiagnosticReport:result&date=ge2010-01-01&date=le2011-12-31 </pre>

# Retrieves all ZIB LaboratoryTestResult DiagnosticReport resources
# Retrieves all ZIB LaboratoryTestResult DiagnosticReport resources that have an effective date greater than 01-01-2010.
# Retrieves all ZIB LaboratoryTestResult DiagnosticReport resources that have an effective date within a 2 year period.
# Retrieves all ZIB LaboratoryTestResult DiagnosticReport resources that have an effective date within a 2 year period and include the referenced Observation resources in the searchresults.

=====Expected Actions=====
The XIS shall process the query to discover DiagnosticReport resources that match the search parameters given.

===XIS: response message===
The XIS returns a HTTP Status code appropriate to the processing as well as a FHIR Bundle including the matching laboratory diagnostic report information.

====Trigger Events====
The XIS completed processing of the retrieve laboratory diagnostic report request message.

====Message Semantics====
Based on the query results, the XIS will either return an error or success. When the XIS needs to report an error, it SHALL use HTTP error response codes and SHOULD include a FHIR OperationOutcome resource with more details on the failure. If the request message is processed successfully, whether or not any DiagnosticReport resources are found, the HTTP status code SHALL be 200.

The response message shall be a Bundle resource of type "searchset" containing zero or more FHIR resources as entries. If the XIS is sending warnings, the Bundle resource SHALL also contain a FHIR OperationOutcome resource that contains those warnings. The FHIR specification describes the relevant sections:
*[http://hl7.org/fhir/STU3/http.html RESTful API framework]
*[http://hl7.org/fhir/STU3/search.html#errors Search errors]
*[http://hl7.org/fhir/STU3/bundle.html Bundle resource]
*[http://hl7.org/fhir/operationoutcome.html OperationOutcome resource]

=====Message resource content=====
The returned data to the PHR should conform to the profiles listed in the table below. This table shows the relevant ZIBs and their related profiles. The resources in the response message SHALL be a valid instance of these profiles. All resources SHALL include their related profile canonical URL in the ''meta.profile'' element in order to show compliance.

{| class="wikitable" width="1400px"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|ZIB name NL||ZIB name EN||FHIR Resource||URL profile||Reference to section
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Patient
| #ZIB Patient|Patient
| Patient
| [https://simplifier.net/NictizSTU3/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_Patient | Patient]]
|-
| Zorgverlener
| HealthProfessional
| Practitioner
| [https://simplifier.net/NictizSTU3/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_HealthProfessional | HealthProfessional]]
|-
| Zorgaanbieder
| HealthcareProvider
| Organization
| [https://simplifier.net/NictizSTU3/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
| [[Bestand: Verwijzing.png| 20px]][[MedMij:V1.0_FHIR_HealthcareProvider | HealthcareProvider]]
|-
| rowspan="3" | LaboratoriumUitslag
| rowspan="3" | LaboratoryTestResult
| DiagnosticReport
| [https://simplifier.net/NictizSTU3/zib-LaboratoryTestResult-DiagnosticReport http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-DiagnosticReport]
| rowspan="3" | [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_LaboratoryTestResult| LaboratoryTestResult]]
|-
| Observation
| [https://simplifier.net/NictizSTU3/zib-LaboratoryTestResult-Observation http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Observation]
|-
| Specimen
| [https://simplifier.net/NictizSTU3/zib-LaboratoryTestResult-Specimen http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Specimen]
|-
|}

====Expected Actions====
The PHR shall process the results according to application-defined rules. The PHR should be robust as the response may contain DiagnosticReport, Observation and Specimen resources that match the query parameters.

==Interactions, operations, search parameters==
===Interactions===
The following logical interactions are needed for the retrieve laboratory results transaction:
* [http://hl7.org/fhir/STU3/http.html#search Search]

===Operations===
No operations are defined or needed for this transaction.

===Search parameters===
The following search parameter type needs to be supported for this transaction.

Search parameter types:
* [http://hl7.org/fhir/STU3/search.html#token token]
* [http://hl7.org/fhir/STU3/search.html#date date]

Search result parameters:
* [http://hl7.org/fhir/STU3/search.html#include _include]

==Examples==

[[categorie:MedMij FHIR Use Cases]]

MedMij:V2018.02 Ontwerpen

2018-03-29T15:27:23Z

Marten Smits:

{{#customtitle:Ontwerpen MedMij|Functioneel Ontwerpen}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.02_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.02_FHIR_IG|Technisch]]
desc none
</imagemap>

=Inleiding=
==Algemeen==
Hier vindt u informatie over de ''inhoud'' van de informatie die kan worden uitgewisseld in het [https://www.medmij.nl/afsprakenstelsel/ MedMij afsprakenstelstel].

Deze pagina beschrijft allereerst de algemeen geldende en overkoepelende informatie van de functionele ontwerpen voor MedMij en bevat vervolgens [[#Ontwerpen|verwijzingen]] naar specifieke functionele ontwerpen en technische specificaties voor die use cases die onderdeel zijn van het afsprakenstelsel.

==Doelgroep==
De doelgroep voor deze pagina bestaat uit:
* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz;
* Vertegenwoordigers van patiënten, laboratoria en zorgverleners.

==Kaders en uitgangspunten==

===Richtlijn===
Het programma '[https://www.registratieaandebron.nl Registratie aan de bron]' heeft zorginformatiebouwstenen voor Nederland gedefinieerd. Een zorginformatiebouwsteen (ZIB) beschrijft nauwkeurig wat er over een bepaald onderwerp van het zorgproces van de patiënt moet worden vastgelegd. Zorginformatiebouwstenen zijn opgesteld vanuit de gedachte dat dezelfde informatie zowel voor artsen, verpleegkundigen, paramedici als patiënten relevant zijn, ieder met hun eigen invalshoek.

Naast deze zorginformatiebouwstenen heeft het programma 'Registratie aan de Bron' ook de zogenaamde '[https://www.nictiz.nl/standaarden/basisgegevensset-zorg Basisgegevensset Zorg]' gedefinieerd. De Basisgegevensset Zorg (BgZ) is de minimale set van patiëntgegevens die specialisme-, ziektebeeld- en beroepsgroepoverstijgend relevant is en van belang voor de continuïteit van zorg voor de patiënt. De Basisgegevensset Zorg is gedefinieerd met behulp van de zorginformatiebouwstenen: het is een ingeperkte set van het totaal aan ZIB's.

Iedereen heeft recht op inzage van gegevens die over jou zijn vastgelegd. MedMij gebruikt de BgZ als leidraad om de uitwisseling van informatie tussen patiënt en professional op gang te brengen. Soms gebruikt de BgZ slechts een deel van een bepaalde ZIB. MedMij kiest ervoor om wél altijd de volledige ZIB te definiëren, zodat contextonafhankelijke implementatie mogelijk wordt. Dit zorgt er ook voor dat interoperabiliteit mogelijk wordt.

Er is een uitzondering gemaakt voor het domein van medicatie. Een programma dat parallel loopt aan MedMij is 'Medicatieproces'. Dit programma heeft de informatiestandaard Medicatieproces versie 9.x opgeleverd en nieuwe zorginformatiebouwstenen gedefinieerd. Deze nieuwe zorginformatiebouwstenen zijn geen onderdeel van BgZ 1.0, maar zijn wél in gebruik voor de functionele definitie voor het uitwisselen van medicatiegegevens in MedMij.

===Infrastructuur===
De berichten beschreven in deze informatiestandaard kunnen over elke willekeurige infrastructuur worden getransporteerd. De specificatie van de infrastructuur en het berichttransport is buiten scope van deze informatiestandaard.

MedMij kent wel een [http://www.medmij.nl/afsprakenstelsel/ afsprakenstelsel] met spelregels die zorgen dat de gegevensuitwisseling veilig is, privacy geborgd is en dat systemen aan juridische eisen voldoen.

===Geografische reikwijdte===
De geografische scope van alle ontwerpen van MedMij is Nederland.

==Kwalificatie==
Op deze informatiestandaard is een Nictiz kwalificatie van toepassing.
Kwalificatie vindt plaats per systeemrol.
Voor meer informatie zie [https://www.nictiz.nl/standaardisatie/kwalificaties de websitepagina over Nictiz kwalificaties].

=Wiki structuuroverzicht=
Onderstaande afbeelding geeft een overzicht van de MedMij wiki pagina structuur. Het afsprakenstelsel verwijst naar de MedMij landingspagina die op zijn beurt verwijst naar de functionele en technische ontwerpen. Vanaf deze pagina, de hoofdpagina van de functionele ontwerpen, wordt verwezen naar de onderliggende functionele ontwerp pagina's middels de onderstaande 'patient journeys' en tabel overzicht. De functionele ontwerp beschrijvingen hebben een technische wiki pagina als tegenhanger. Vanuit de leeswijzer afbeelding, bestaande uit drie iconen, bovenaan de pagina is het mogelijk makkelijk door te linken naar de technische pagina's.

[[Bestand:MedMij wiki structuur overzicht.png|link= |650px|MedMij Wiki structuur overzicht]]

=Ontwerpen=
Patient journeys beschrijven de mogelijkheden die MedMij biedt vanuit het perspectief van een fictieve patiënt. Deze paragraaf start met de [[#Patient_journeys| Patient journeys]] die MedMij hanteert.

De paragraaf vervolgt met een index in tabelvorm gesplitst naar de use cases van het afsprakenstelsel:
* [[#Haal_gegevens_op_uit_XIS|Haal gegevens op uit XIS]]
* [[#Stuur_gegevens_naar_XIS|Stuur gegevens naar XIS]]
==Patient journeys==
===Thomas van Beek===
De beschrijving van de casus van de fictieve patiënt Thomas van Beek vindt u [https://www.nictiz.nl/SiteCollectionDocuments/Overig/Casus_Thomas_van_Beek_MedMij.pdf hier].

Onderstaand een grafische weergave van de tijdlijn van Thomas. Het is mogelijk te klikken op de groene PGO-cirkels, deze linken - indien beschikbaar - naar ontwerpspecificaties.
<imagemap>Bestand:journey-02.png|alt=Tijdlijn van Thomas. Het is mogelijk te klikken op de groene PGO-cirkels. | 1100px

circle 553 322 90 [[MedMij:V2018.02_OntwerpeAfspraken|eAfspraken]]
circle 1151 120 91 [[MedMij:Verwijzingen|Verwijzingen]]
circle 1941 155 91 [[MedMij:V2018.02_OntwerpMedicatie#Use_case:_Raadplegen_medicatieoverzicht_door_pati.C3.ABnt|Medicatieoverzicht]]
circle 1644 1296 91 [[MedMij:V2018.02_OntwerpBGZ_2017#Use_case_1:_Raadplegen_Basisgegevensset_Zorg_in_persoonlijke_gezondheidsomgeving|Basisgegevensset Zorg]]
circle 1302 1273 91 [[MedMij:Beelden|Beelden]]
circle 930 1161 91 [[MedMij:V2018.02_OntwerpLabresult#Use_case:_Raadplegen_laboratoriumresultaten_in_persoonlijke_gezondheidsomgeving|Laboratoriumresultaten]]
circle 629 1320 91 [[MedMij:V2018.02_OntwerpLabresult#Use_case:_Raadplegen_laboratoriumresultaten_in_persoonlijke_gezondheidsomgeving|Laboratoriumresultaten]]
desc none
</imagemap>

===Roos Dalstra===
De beschrijving van de casus van de fictieve patiënt Roos Dalstra vindt u [https://www.nictiz.nl/SiteCollectionDocuments/Overig/Casus_Roos_Dalstra_MedMij.pdf hier].

Onderstaand een grafische weergave van de tijdlijn van Roos. Het is mogelijk te klikken op de groene PGO-cirkels, deze linken - indien beschikbaar - naar ontwerpspecificaties.

<imagemap>Bestand:Patient Journey - Roos Dalstra_20180109_2000.png|alt=Tijdlijn van Roos Dalstra. Het is mogelijk te klikken op de groene PGO-cirkels. | 1100px

circle 608 380 73 [[MedMij:V2018.02_OntwerpZelfmetingen|Zelfmetingen]]
circle 952 235 73 [[MedMij:V2018.02_OntwerpMedicatie#Use_case:_Raadplegen_medicatieoverzicht_door_pati.C3.ABnt|Medicatieoverzicht]]
circle 1237 422 74 [[MedMij:V2018.02_OntwerpHuisartsgegevens|Huisartsgegevens]]
circle 1605 111 74 [[MedMij:V2018.02_OntwerpAllergieIntolerantie|Allergie intolerantie]]
circle 707 912 74 [[MedMij:V2018.02_OntwerpeAfspraken|eAfspraken]]
circle 1195 1141 74 [[MedMij:V2018.02_OntwerpMedicatie|Medicatie]]
circle 1412 1139 74 [[MedMij:V2018.02_OntwerpLabresult|Laboratoriumresultaten]]
circle 1692 1074 74 [[MedMij:V2018.02_OntwerpPDFA|PDF/A]]
desc none
</imagemap>

==Haal gegevens op uit XIS==

Een persoonlijke gezondheidsomgeving (PGO) haalt gegevens op bij een zorginformatiesystemen (XIS). Onderstaande tabel geeft een overzicht van de use cases uit informatiestandaarden die van toepassing zijn voor het raadplegen van informatie.

{| class="wikitable"
| style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="6" | Index raadplegen / beschikbaar stellen
|-style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;"
|style="width:200px; border: 1px solid black;" colspan="2"| Informatiestandaard
|style="width:20px; border: 1px solid black;"| Versie
|style="width:600px; border: 1px solid black;"| Use case
|style="width:200px; border: 1px solid black;"| Functioneel
|style="width:200px; border: 1px solid black;"| Technisch
|-style="background-color: white;"
|[[Bestand:BGZ_icoon_zonder_tekst.png|link=https://www.nictiz.nl/standaarden/basisgegevensset-zorg|Basissetgegevens Zorg|49px]]||[https://www.nictiz.nl/standaarden/basisgegevensset-zorg Basisgegevensset Zorg]||||[https://www.nictiz.nl/standaarden/basisgegevensset-zorg Basisgegevensset Zorg], op basis van ZIB's release 2017||[[MedMij:V2018.02_OntwerpBGZ_2017#Use_case_1:_Raadplegen_Basisgegevensset_Zorg_in_persoonlijke_gezondheidsomgeving|BgZ]]||[[MedMij:V2018.02_FHIR_BGZ_2017|BgZ in FHIR]]
|-
|[[Bestand:Lab.png|link=https://www.nictiz.nl/standaardisatie/informatiestandaarden/laboratoria|Labuitwisseling|49px]]||[https://www.nictiz.nl/standaardisatie/informatiestandaarden/laboratoria Labuitwisseling]||||Laboratoriumresultaten ||[[MedMij:V2018.02_OntwerpLabresult#Use_case:_Raadplegen_laboratoriumresultaten_in_persoonlijke_gezondheidsomgeving|Laboratoriumresultaten]]||[[MedMij:V2018.02_FHIR_LaboratoryResults|Laboratoriumresultaten in FHIR]]
|-style="background-color: white;"
|rowspan="2"|[[Bestand:Medicatie.png|49px]]
|rowspan="2"|[https://www.nictiz.nl/Paginas/Informatiestandaard-Medicatieproces.aspx Medicatieproces]
|rowspan="2"|
||Medicatieoverzicht
||[[MedMij:V2018.02_OntwerpMedicatie#Use_case:_Raadplegen_medicatieoverzicht_in_persoonlijke_gezondheidsomgeving|Medicatieoverzicht]]
||[[MedMij:V2018.02_FHIR_MedicationProcess#Use_case:_retrieve_medication_overview |Medicatieoverzicht in FHIR]]
|-style="background-color: white;"
||Medicatiegegevens ||[[MedMij:V2018.02_OntwerpMedicatie#Use_case:_Raadplegen_medicatiegegevens_door_pati.C3.ABnt|Medicatiegegevens]]
||[[MedMij:V2018.02_FHIR_MedicationProcess#Use_case:_retrieve_medication_information |Medicatiegegevens in FHIR]]
|-
|[[Bestand:Allergie.png|link=https://www.nictiz.nl/standaardisatie/informatiestandaarden/medicatieveiligheid| Medicatieveiligheid|49px]]|||[https://www.nictiz.nl/standaardisatie/informatiestandaarden/medicatieveiligheid Medicatieveiligheid]
|||Allergie/intolerantie ||[[MedMij:V2018.02_OntwerpAllergieIntolerantie| AllergieIntolerantie]] ||[[MedMij:V2018.02_FHIR_AllergyIntolerance|AllergieIntolerantie in FHIR]]
|-style="background-color: white;"
|[[Bestand:EAfspraak_icoon_zonder_tekst.png|link=MedMij:V2018.02_OntwerpeAfspraken|49px]]
||eAfspraken
||||Afspraak raadplegen
||[[MedMij:V2018.02_OntwerpeAfspraken#Use_case:_Afspraak_raadplegen_door_pati.C3.ABnt| eAfspraken]]
|| [[MedMij:V2018.02_FHIR_eAfspraak| eAfspraken in FHIR]]
|-
|[[Bestand:Self-Measuements_zonder_tekst.png|link=|49px]]||||||Zelfmetingen ||[[MedMij:V2018.02_OntwerpZelfmetingen|Zelfmetingen]]||[[MedMij:V2018.02_FHIR_VitalSigns|Zelfmetingen in FHIR]]
|-style="background-color: white;"
|[[Bestand:PDF-A_icoon_zonder_tekst.png|PDF/A|49px]]||||||PDF/A ||[[MedMij:V2018.02_OntwerpPDFA| PDF/A]] ||[[MedMij:V2018.02_FHIR_PDFA|PDF/A in FHIR]]
|-
|-
|[[Bestand:Huisartsgegevens.png|49px|Huisartsgegevens]]||Huisartsgegevens|||| Huisartsgegevens || [[MedMij:V2018.02_OntwerpHuisartsgegevens|Huisartsgegevens]] ||[[MedMij:V2018.02_FHIR_GP_Data|GP Data in FHIR]]
|-style="background-color: white;"
|[[Bestand:Indicatiebesluit_icoon_zonder_tekst.png|49px|Indicatiestelling]]||||||Indicatiestelling || ||
|}

==Stuur gegevens naar XIS==
Een persoonlijke gezondheidsomgeving (PGO) stuurt gegevens naar een zorginformatiesystemen (XIS). Onderstaande tabel geeft een overzicht van de use cases uit informatiestandaarden die van toepassing zijn voor het sturen van informatie.

{| class="wikitable"
| style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="6" | Index sturen / ontvangen
|-style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;"
|style="width:200px; border: 1px solid black;" colspan="2"| Informatiestandaard
|style="width:20px; border: 1px solid black;"| Versie
|style="width:600px; border: 1px solid black;"| Use case
|style="width:200px; border: 1px solid black;"| Functioneel
|style="width:200px; border: 1px solid black;"| Technisch
|-
|[[Bestand:Lab.png|link=https://www.nictiz.nl/standaardisatie/informatiestandaarden/laboratoria|Labuitwisseling|50px]]||[https://www.nictiz.nl/standaardisatie/informatiestandaarden/laboratoria Labuitwisseling]
||||Laboratorium resultaat (bijvoorbeeld: zelfmeting) ||||[[MedMij:V2018.02_FHIR_LaboratoryResults|Lab resultaat in FHIR]]

|-style="background-color: white;"
|[[Bestand:Self-Measuements_zonder_tekst.png|link=|50px]]||||||Zelfmetingen ||[[MedMij:V2018.02_OntwerpZelfmetingen#Use_case:_Sturen_zelfmetingen_van_de_vitale_functies_door_pati.C3.ABnt|Zelfmetingen]]||[[MedMij:V2018.02_FHIR_VitalSigns|Zelfmetingen in FHIR]]
|-
|rowspan="3"|[[Bestand:EAfspraak_icoon_zonder_tekst.png|link=MedMij:V2018.02_OntwerpeAfspraken|50px]]
|rowspan="3"|eAfspraken
|rowspan="3"|
||Afspraak maken
||[[MedMij:V2018.02_OntwerpeAfspraken#Use_case:_Afspraak_maken_door_pati.C3.ABnt| eAfspraak maken]]
||
|-
|Afspraak annuleren
||[[MedMij:V2018.02_OntwerpeAfspraken#Use_case:_Afspraak_annuleren_door_pati.C3.ABnt| eAfspraak annuleren]]
||
|-
|Afspraak wijzigen
||[[MedMij:V2018.02_OntwerpeAfspraken#Use_case:_Afspraak_wijzigen_door_pati.C3.ABnt| eAfspraak wijzigen]]
||
|-style="background-color: white;"
|[[Bestand:PDF-A_icoon_zonder_tekst.png|link=|PDF/A|50px]]||PDF/A||||PDF/A|||[[MedMij:V2018.02_OntwerpPDFA#Use_case:_Sturen_medische_gegevens_in_PDF.2FA_door_pati.C3.ABnt| PDF/A]]||[[MedMij:V2018.02_OntwerpPDFA| PDF/A in FHIR]]
|}

=Systeemrollen=
In onderstaande tabel zijn alle systeemrollen opgenomen die van toepassing zijn in de MedMij use cases. De syteemrolcode is gebaseerd op de informatiestandaard inclusief versie, de transactie en uitwisselingsstandaard. De code is als volgt opgebouwd: afkorting informatiestandaard - versie - afkorting transactie - uitwisselingsstandaard. Wanneer er geen informatiestandaard beschikbaar is, wordt de afkorting MM (MedMij) gebruikt.

De kolom 'Afsprakenstelsel release' geeft informatie over de versie van het afsprakenstelsel waarin de systeemrol is opgenomen. Wanneer een systeemrol geen afsprakenstelsel releasenummer heeft betekent dat deze nog niet is opgenomen.

De kolom 'MMVN' geeft een indicatie van de volwassenheid van de standaarden, conform verschillende MedMij VolwassenheidsNiveaus (MMVN) die binnen het afsprakenstelsel worden onderscheiden. Standaarden krijgen een MedMij niveau als ze ook daadwerkelijk toegepast kunnen worden binnen MedMij Afsprakenstelsel. Vooralsnog valt PUSH daar bijvoorbeeld buiten, en hebben systeemrollen van PUSH transactiegroepen een MMVN van '0'. Nadere toelichting ten aanzien van MedMij VolwassenheidNiveaus vindt u [http://www.medmij.nl/wp-content/uploads/2017/11/Co%C3%B6rdinatie-standaarden-MedMij-Governance.pdf hier].

{| class="wikitable"
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" colspan=2 |Informatiestandaard
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Transactiegroep
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Transactie
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Systeem
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Systemrolcode
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Afsprakenstelsel release
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |MMVN
|-
| rowspan="2" | [[Bestand:BGZ_icoon_zonder_tekst.png|link=https://www.nictiz.nl/standaarden/basisgegevensset-zorg|Basissetgegevens Zorg|50px]]
| rowspan="2" | Basisgegevensset Zorg
| rowspan="2" | BgZ (PULL)
| Raadplegen BgZ
| PGO
| MM-1.0.0-BZR-FHIR
| R1.0
| 3
|-
| Beschikbaar stellen BgZ
| XIS
| MM-1.0.0-BZB-FHIR
| R1.0
| 3
|-
| rowspan="4" | [[Bestand:Medicatie.png|https://www.nictiz.nl/Paginas/Informatiestandaard-Medicatieproces.aspx| Medicatieproces|50px]]
| rowspan="4" | Medicatieproces
| rowspan="2" | Medicatieoverzicht (PULL)
| Raadplegen medicatieoverzicht
| PGO
| MP-9.0.4-MOR-FHIR
| R1.0
| 3
|-
| Beschikbaar stellen medicatieoverzicht
| XIS
| MP-9.0.4-MOB-FHIR
| R1.0
| 3
|-
| rowspan="2" | Medicatiegegevens (PULL)
| Raadplegen medicatiegegevens
| PGO
| MP-9.0.4-MGR-FHIR
| R1.0
| 3
|-
| Beschikbaar stellen medicatiegegevens
| XIS
| MP-9.0.4-MGB-FHIR
| R1.0
| 3
|-
| rowspan="2" | [[Bestand:Lab.png|link=https://www.nictiz.nl/standaardisatie/informatiestandaarden/laboratoria|Labuitwisseling|50px]]
| rowspan="2" | Labuitwisseling
| rowspan="2" | Laboratoriumresultaten (PULL)
| Raadplegen laboratoriumresultaten
| PGO
| LAB-1.0.0-LRR-FHIR
| R1.0
| 3
|-
| Beschikbaar stellen laboratoriumresultaten
| XIS
| LAB-1.0.0-LRB-FHIR
| R1.0
| 3
|-
| rowspan="4" | [[Bestand:Self-Measuements_zonder_tekst.png|link=|50px]]
| rowspan="4" |
| rowspan="2" | Meetwaarden vitale functies (PULL)
| Raadplegen meetwaarden vitale functies
| PGO
| MM-1.0.0-MVR-FHIR
| R1.0
| 3
|-
| Beschikbaar stellen meetwaarden vitale functies
| XIS
| MM-1.0.0-MVB-FHIR
| R1.0
| 3
|-
| rowspan="2" | Zelfmetingen vitale functies (PUSH)
| Sturen zelfmetingen van vitale functies
| PGO
| MM-1.0.0-ZVS-FHIR
| -
| 0
|-
| Ontvangen zelfmetingen vitale functies
| XIS
| MM-1.0.0-ZVO-FHIR
| -
| 0
|-
| rowspan="6" | [[Bestand:PDF-A_icoon_zonder_tekst.png|PDF/A|50px]]
| rowspan="6" |
| rowspan="2" | PDFA metadata lijst (PULL)
| Raadplegen PDF/A metadata lijst
| PGO
| MM-1.0.0-PLR-FHIR
| R1.0
| 3
|-
| Beschikbaar stellen PDF/A metadata lijst
| XIS
| MM-1.0.0-PLB-FHIR
| R1.0
| 3
|-
| rowspan="2" | PDFA (PULL)
| Raadplegen PDF/A
| PGO
| MM-1.0.0-PDR-FHIR
| R1.0
| 3
|-
| Beschikbaar stellen PDF/A
| XIS
| MM-1.0.0-PDB-FHIR
| R1.0
| 3
|-
| rowspan="2" | PDFA (PUSH)
| Sturen PDF/A
| PGO
| MM-1.0.0-PDS-FHIR
| -
| 0
|-
| Ontvangen PDF/A
| XIS
| MM-1.0.0-PDO-FHIR
| -
| 0
|-
| rowspan="2" | [[Bestand:Allergie.png|link=https://www.nictiz.nl/standaardisatie/informatiestandaarden/medicatieveiligheid| Medicatieveiligheid|50px]]
| rowspan="2" | Medicatieveiligheid
| rowspan="2" | AllergieIntolerantie gegevens (PULL)
| Raadplegen AllergieIntolerantie gegevens
| PGO
| MP-6.12.6-AIR-FHIR
| R1.0
| 3
|-
| Beschikbaar stellen AllergieIntolerantie gegevens
| XIS
| MP-6.12.6-AIB-FHIR
| R1.0
| 3
|-
| rowspan="12" | [[Bestand:EAfspraak_icoon_zonder_tekst.png|link=MedMij:V2018.02_OntwerpeAfspraken|50px]]
| rowspan="12" | eAfspraken
| rowspan="2" | Afspraken (PULL)
| Raadplegen afspraak
| PGO
| EA-1.0.0-AFR-FHIR
| R1.0
| 3
|-
| Beschikbaar stellen afspraak
| XIS
| EA-1.0.0-AFB-FHIR
| R1.0
| 3
|-
| rowspan="2" | AfspraakSlots (PULL)
| Raadplegen afspraak slots
| PGO
| EA-1.0.0-ASR-FHIR
| -
| 1
|-
| Beschikbaar stellen afspraak slots
| XIS
| EA-1.0.0-ASB-FHIR
| -
| 1
|-
| rowspan="2" | AfspraakType (PULL)
| Raadplegen afspraak typen
| PGO
| EA-1.0.0-ATR-FHIR
| -
| 1
|-
| Beschikbaar stellen afspraak typen
| XIS
| EA-1.0.0-ATB-FHIR
| -
| 1
|-
| rowspan="2" | AfspraakVerzoek (PUSH)
| Sturen afspraakverzoek
| PGO
| EA-1.0.0-AVS-FHIR
| -
| 1
|-
| Ontvangen afspraakverzoek
| XIS
| EA-1.0.0-AVO-FHIR
| -
| 1
|-
| rowspan="2" | AfspraakAnnulering (PUSH)
| Sturen afspraak annulering
| PGO
| EA-1.0.0-AAS-FHIR
| -
| 1
|-
| Ontvangen afspraak annulering
| XIS
| EA-1.0.0-AAO-FHIR
| -
| 1
|-
| rowspan="2" | AfspraakWijziging (PUSH)
| Sturen afspraak wijzigingsverzoek
| PGO
| EA-1.0.0-AWS-FHIR
| -
| 1
|-
| Ontvangen afspraak wijzigingsverzoek
| XIS
| EA-1.0.0-AWO-FHIR
| -
| 1
|-
| rowspan="2" | [[Bestand:Huisartsgegevens.png|link=MedMij:V2018.02_OntwerpHuisartsgegevens|Huisartsgegevens|50px]]
| rowspan="2" | Huisartsgegevens
| rowspan="2" | Huisartsgegevens (PULL)
| Raadplegen Huisartsgegevens
| PGO
| MM-1.0.0-HGR-FHIR
| -
| 1
|-
| Beschikbaar stellen Huisartsgegevens
| XIS
| MM-1.0.0-HGB-FHIR
| -
| 1
|}

MedMij:V2018.02 OntwerpeAfspraken

2018-03-29T15:27:11Z

Marten Smits:

{{#customtitle:Use Cases eAfspraken, draft version}}

[[Bestand:EAfspraak_icoon_zonder_tekst.png |link=|links |87px|eAfspraken]]
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.02_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.02_FHIR_eAfspraak|Tecnical]]
desc none
</imagemap>

<div class="toclimit-{{{2|{{{limit|3}}}}}}">__TOC__</div>

=Inleiding=
Deze pagina beschrijft use cases waarbij een patiënt afspraken kan raadplegen, maken, annuleren of wijzigen met behulp van een persoonlijke gezondheidsomgeving. Algemene informatie betreffende deze use cases kan gevonden worden op deze [https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2017.02_Ontwerpen wiki pagina].

=Use Cases=
Deze sectie vervolgt met de volgende use cases:
*[[#Use_case:_Afspraak_raadplegen_door_pati.C3.ABnt|Afspraak raadplegen]]
*[[#Use_case:_Afspraak_maken_door_pati.C3.ABnt|Afspraak maken]]
*[[#Use_case:_Afspraak_annuleren_door_pati.C3.ABnt|Afspraak annuleren]]
*[[#Use_case:_Afspraak_wijzigen_door_pati.C3.ABnt|Afspraak wijzigen]]
==Use case: Afspraak raadplegen door patiënt==
===Doel en relevantie===
Inzicht in afspraken biedt patiënten overzicht en gebruiksgemak. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van afspraken vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===

====Raadplegen afspraak ====
Het raadplegen van een afspraak gaat van een specifieke patiënt naar een specifieke organisatie in de zorg (bijvoorbeeld een zorgaanbieder).

Verdere informatie-elementen in de vraag om afspraken zijn:
*periode (startdatum - einddatum) waarin de afspraak plaats heeft gehad / heeft / zal hebben
Dit betreft dus de filtermogelijkheden (query parameters) in de vraag om afspraken.

====Beschikbaarstellen afspraak ====
De informatie-elementen voor beschikbaarstellen afspraak staan in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraken]

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil afspraken raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt afspraken beschikbaar
|}
'''Bedrijfsrollen afspraak inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak raadplegen.png|Activiteitendiagram afspraak raadplegen]]

'''Activiteitendiagram afspraak raadplegen'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/SiteCollectionDocuments/Overig/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een aantal voor Thomas relevante situaties waarbij het raadplegen van afspraken een rol speelt.

<blockquote>Thomas heeft iedere drie maanden een controle in het ziekenhuis in verband met zijn Diabetes aandoening. De eerstkomende afspraak is op vrijdag 6 oktober 2017 om 10:30u met internist Janssen bij het Antonius Ziekenhuis in Rotterdam en duurt een uur. Het ziekenhuisinformatiesysteem heeft deze afspraak beschikbaar gemaakt voor de persoonlijke gezondheidsomgeving van Thomas. Thomas kan deze afspraak dan ook inzien via zijn persoonlijke gezondheidsomgeving.
----
Op 6 september belt de afdelingssecretaresse van het ziekenhuis. Zij heeft het verzoek aan Thomas of de afspraak verzet kan worden naar dinsdag 3 oktober om 16:00 uur. Dat komt hem prima uit, dus hij gaat akkoord. Het ziekenhuisinformatiesysteem maakt deze nieuwe afspraakinformatie beschikbaar voor de persoonlijke gezondheidsomgeving. Wanneer Thomas later die dag kijkt, ziet hij ook de bijgewerkte afspraakinformatie in zijn persoonlijke gezondheidsomgeving. Wel zo makkelijk, want hij was het eerder die dag vergeten op te schrijven.
</blockquote>

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het systeem van een zorgaanbieder (XIS) stelt de afspraak beschikbaar aan het systeem van een patiënt (PGO).
Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.
=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

De patiënt wil afspraken inzien en de zorgaanbieder stelt dit ook beschikbaar.
:Een patiënt kan steeds zelf het initiatief nemen om zijn afspraken op te halen, maar het is ook mogelijk dat een PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de beschrijving van deze use case geen verschil.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om afspraken in te zien.

=====Post conditie=====
De patiënt heeft afspraken geraadpleegd via de persoonlijke gezondheidsomgeving.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om afspraken van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| AfspraakRaadplegend
| style="background-color: white;"| EA-1.0.0-AFR-FHIR
| style="background-color: white;"| Raadplegen afspraak bij zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| AfspraakBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak aan de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak raadplegen (Totaal).png |Componenten diagram afspraak raadplegen]]

'''Componenten diagram afspraak raadplegen'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2018.02_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak raadplegen.png|Use case diagram afspraak raadplegen]]

'''Use case diagram afspraak raadplegen

==Use case: Afspraak maken door patiënt==
===Doel en relevantie===
Het maken van afspraken via een persoonlijke gezondheidsomgeving biedt patiënten gebruiksgemak. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het elektronisch en gestructureerd afspraken kunnen maken vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn vastgelegd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraken].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots
Raadplegen afspraak typen

Sturen afspraakverzoek
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots
Beschikbaarstellen afspraak typen

Ontvangen afspraak verzoek
|}
'''Bedrijfsrollen Afsrpraak inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak maken.png|Activiteitendiagram afspraak maken]]

'''Activiteitendiagram maken afspraak'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/SiteCollectionDocuments/Overig/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het maken van afspraken een rol speelt.

<blockquote>De persoonlijke gezondheidsomgeving van Thomas en het ziekenhuisinformatiesysteem (ZIS) van het Noorderziekenhuis in Groningen zijn verbonden vanwege een eerder bezoek van Thomas in het ziekenhuis.

Thomas wil een afspraak maken voor de driemaandelijkse controle met een diabetesverpleegkundige. Hij wil dit ergens in de tweede week van januari. Zijn persoonlijke gezondheidsomgeving haalt de beschikbare tijden voor deze afspraak op uit het Groningse ziekenhuisinformatiesysteem. Thomas kiest voor woensdag 10 januari van 14:00 – 15:00 uur. Dit verzoek gaat via zijn persoonlijke gezondheidsomgeving naar het ziekenhuisinformatiesysteem, dat deze afspraak bevestigt. De afspraak is vanaf nu ook inzichtelijk voor Thomas via zijn persoonlijke gezondheidsomgeving.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Een persoonlijke gezondheidsomgeving kan achterhalen welk type afspraken het verbonden XIS ondersteunt: dit betreft het raadplegen van typen afspraken. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan voor een bepaalde periode én een bepaald type afspraak de beschikbare tijden ophalen uit het XIS. Dit betreft het raadplegen van beschikbare afspraak slots. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan - op basis van beschikbare slots - een verzoek tot het maken van een concrete afspraak doen aan het XIS. Een XIS kan een dergelijk afspraakverzoek behandelen en adequaat beantwoorden.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch maken van afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil bepaalde typen afspraken maken en de zorgaanbieder ondersteunt het maken van deze afspraken.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare typen afspraken die gemaakt kunnen worden bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de typen afspraken.
*Het systeem van de patiënt (PGO) vraagt om beschikbare slots voor een bepaald type afspraak in een bepaalde tijdsperiode bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de beschikbare afspraak slots op basis van de filter criteria uit de persoonlijke gezondheidsomgeving.
*Het systeem van de patiënt (PGO) stuurt een verzoek om een bepaald type afspraak te maken in een bepaalde slot.
*Het systeem van de zorgaanbieder (XIS) ontvangt het afspraakverzoek en beantwoord deze. Het antwoord kan positief of negatief zijn.

Bij een eventueel negatief antwoord van het XIS kan een patiënt ervoor kiezen het opnieuw proberen, bijvoorbeeld met een ander (opnieuw opgevraagd) slot.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een afspraakverzoek.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="3"| PGO
| style="background-color: white;"| AfspraakTypenRaadplegend
| style="background-color: white;"| EA-1.0.0-ATR-FHIR
| style="background-color: white;"| Raadplegen afspraak typen bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakSlotsRaadplegend
| style="background-color: white;"| EA-1.0.0-ASR-FHIR
| style="background-color: white;"| Raadplegen afspraak slots bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakverzoekSturend
| style="background-color: white;"| EA-1.0.0-AVS-FHIR
| style="background-color: white;"| Sturen afspraakverzoek naar zorgaanbieder
|-
| style="background-color: white;" rowspan="3"| XIS
| style="background-color: white;"| AfspraakTypenBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ATB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak typen
|-
| style="background-color: white;"| AfspraakSlotsBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ASB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak slots
|-
| style="background-color: white;"| AfspraakverzoekOntvangend
| style="background-color: white;"| EA-1.0.0-AVO-FHIR
| style="background-color: white;"| Ontvangen afspraakverzoek van de patient
|-
|}
Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak maken (Totaal).png|Componenten diagram afspraak maken]]

'''Componenten diagram afspraak maken'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakSlots (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="6"|[[MedMij:V2018.02_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakTypen (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak typen
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ATR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak typen
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ATB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakVerzoek (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraakverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AVS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraakverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AVO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak maken.png|Use case diagram afspraak maken]]

'''Use case diagram afspraak maken

==Use case: Afspraak annuleren door patiënt==
===Doel en relevantie===
Inzicht in afspraken biedt patiënten overzicht en gebruiksgemak. Dat is een functionaliteit die voorwaardelijk is voor deze use case: 'annuleren van afspraken'. Een patiënt is verder geholpen door ook afspraken te kunnen annuleren vanuit een persoonlijke gezondheidsomgeving. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het kunnen annuleren van een afspraak vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn gedefinieerd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraken].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
Sturen afspraak annulering
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
Ontvangen afspraak annulering
|}
'''Bedrijfsrollen afspraken inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak annuleren.png|Activiteitendiagram afspraak annuleren]]

'''Activiteitendiagram afspraak annuleren'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/SiteCollectionDocuments/Overig/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het annuleren van afspraken een rol speelt.

<blockquote>Thomas verhuist halverwege oktober 2017 voor zijn afstuderen naar Groningen. De afspraak voor de driemaandelijkse controle was al gemaakt in Rotterdam voor vrijdag 5 januari 2018. Thomas wil nu die afspraak afzeggen omdat hij die dag bezet is vanwege zijn afstudeerstage. Een nieuwe afspraak maakt hij liever in Groningen, dat is voor hem nu veel handiger.
Hij gebruikt zijn PGO om een verzoek te doen de afspraak in Rotterdam te annuleren. Een aantal uren later bevestigt de medisch secretaresse deze annulering en via het Rotterdamse ziekenhuisinformatiesysteem gaat deze informatie terug naar het PGO. Thomas krijgt hiervan weer een notificatie op zijn mobieltje en hij kan alles inzien in zijn PGO.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Een persoonlijke gezondheidsomgeving kan achterhalen welk afspraken het verbonden XIS heeft voor de patiënt. Dit betreft het raadplegen van afspraken. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan voor een bestaande afspraak een verzoek doen tot annulering. Een XIS ontvangt, behandelt en beantwoordt een dergelijk verzoek.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van informatie over afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil bepaalde afspraken kunnen annuleren en de zorgaanbieder ondersteunt dit.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Het systeem van de patiënt (PGO) stuurt een verzoek om de bestaande afspraak te annuleren.
*Het systeem van de zorgaanbieder (XIS) ontvangt de annulering en beantwoordt deze. Het antwoord kan positief of negatief zijn voor het doorvoeren van de annulering.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een verzoek tot annulering van een afspraak.

Bij een eventueel negatief antwoord van het XIS kan een patiënt ervoor kiezen het opnieuw te proberen, of op een andere manier de zorgaanbieder te benaderen.
Bij een positief antwoord is de afspraak geannuleerd en daarom niet langer aanwezig in zowel XIS als PGO.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="2"| PGO
| style="background-color: white;"| AfsprakenRaadplegend
| style="background-color: white;"| EA-1.0.0-AFR-FHIR
| style="background-color: white;"| Raadplegen afspraken bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakAnnuleringSturend
| style="background-color: white;"| EA-1.0.0-AAS-FHIR
| style="background-color: white;"| Sturen afspraak annulering naar de zorgaanbieder
|-
| style="background-color: white;" rowspan="2"| XIS
| style="background-color: white;"| AfsprakenBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraken aan de patiënt
|-
| style="background-color: white;"| AfspraakAnnuleringOntvangend
| style="background-color: white;"| EA-1.0.0-AAO-FHIR
| style="background-color: white;"| Ontvangen afspraak annulering van de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak annuleren (Totaal).png |Componenten diagram afspraak annuleren]]

'''Componenten diagram afspraak annuleren'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="4"|[[MedMij:V2018.02_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakAnnulering (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraak annulering
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AAS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraak annulering
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AAO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak annuleren.png |Use case diagram afspraak annuleren]]

'''Use case diagram afspraak annuleren

==Use case: Afspraak wijzigen door patiënt==
===Doel en relevantie===
Inzicht in en het maken van afspraken biedt patiënten overzicht en gebruiksgemak. Dat zijn functionaliteiten die voorwaardelijk zijn voor deze use case: 'wijzigen van afspraken'. Een patiënt is verder geholpen door ook afspraken te kunnen wijzigen vanuit een persoonlijke gezondheidsomgeving. Een wijziging kan ook een annulering betreffen. Dit draagt verder bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het kunnen wijzigen van een afspraak vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS).

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn gedefinieerd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraken].

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
Raadplegen afspraak typen

Raadplegen afspraak slots

Sturen afspraak wijzigingsverzoek
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
Beschikbaarstellen afspraak typen

Beschikbaarstellen afspraak slots

Ontvangen afspraak wijzigingsverzoek
|}
'''Bedrijfsrollen afspraken inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Afspraak wijzigen.png|Activiteitendiagram afspraak wijzigen]]

'''Activiteitendiagram afspraak wijzigen'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas vindt u [https://www.nictiz.nl/SiteCollectionDocuments/Overig/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een voor Thomas relevante situatie waarbij het wijzigen van afspraken een rol speelt.

<blockquote>In de loop van december krijgt Thomas een buitenkansje. Een aantal van zijn vrienden gaan met skivakantie van zaterdag 5 t/m 12 januari en er is een plekje vrijgekomen. Voor een zacht prijsje kan hij mee. Daar heeft hij veel zin in!

Thomas zet de skivakantie ‘s avonds laat in zijn agenda en ziet dat dit conflicteert met zijn controle-afspraak in het Noorderziekenhuis op 10 januari. Hij moet die afspraak gaan verzetten. Het is 23:15 en dus te laat om het ziekenhuis hiervoor direct te bellen.

Via zijn PGO kijkt hij daarom naar beschikbare tijden in de derde week van januari. Er blijkt gelukkig nog een gaatje te zijn op vrijdag 19 januari om 11:30 – 12:30. Het verzoek om te wijzigen gaat via zijn PGO naar het ZIS, dat deze afspraak bevestigt. De afspraak is vanaf nu ook inzichtelijk voor Thomas via zijn PGO.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Het systeem van een zorgaanbieder (XIS) stelt afspraken beschikbaar aan het systeem van een patiënt (PGO).
*Een persoonlijke gezondheidsomgeving kan achterhalen welk type afspraken het verbonden XIS ondersteunt: dit betreft het raadplegen van typen afspraken. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan voor een bepaalde periode én een bepaald type afspraak de beschikbare tijden ophalen uit het XIS. Dit betreft het raadplegen van beschikbare afspraak slots. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan - op basis van beschikbare slots - een verzoek tot het wijzigen van een concrete afspraak doen aan het XIS. Een XIS kan een dergelijk afspraak wijzigingsverzoek behandelen en adequaat beantwoorden.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van informatie over afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil een afspraak wijzigen en de zorgaanbieder ondersteunt het wijzigen van afspraken.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om afspraken in te zien en er één te selecteren die hij wil wijzigen.
*Het systeem van de patiënt (PGO) vraagt om beschikbare typen afspraken die gemaakt kunnen worden bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de typen afspraken.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om beschikbare typen afspraken in te zien en er één te selecteren.
*Het systeem van de patiënt (PGO) vraagt om beschikbare slots voor een bepaald type afspraak in een bepaalde tijdsperiode bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de beschikbare afspraak slots op basis van de filter criteria uit de persoonlijke gezondheidsomgeving.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om beschikbare slots in te zien en er één te selecteren.
*Het systeem van de patiënt (PGO) stuurt een verzoek om de bestaande afspraak te wijzigen.
*Het systeem van de zorgaanbieder (XIS) ontvangt het afspraak wijzigingsverzoek en beantwoordt deze als één geheel. Het antwoord kan positief of negatief zijn voor de wijziging.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een afspraak wijzigingsverzoek.

Bij een eventueel negatief antwoord van het XIS kan een patiënt ervoor kiezen het opnieuw proberen, bijvoorbeeld met een ander (opnieuw opgevraagd) slot.
Bij een positief antwoord is de afspraak gewijzigd en inzichtelijk in zowel XIS als PGO.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="4"| PGO
| style="background-color: white;"| AfspraakRaadplegend
| style="background-color: white;"| EA-1.0.0-AFO-FHIR
| style="background-color: white;"| Raadplegen afspraak bij zorgaanbieder
|-
| style="background-color: white;"| AfspraakTypenRaadplegend
| style="background-color: white;"| EA-1.0.0-ATR-FHIR
| style="background-color: white;"| Raadplegen afspraak typen bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakSlotsRaadplegend
| style="background-color: white;"| EA-1.0.0-ASR-FHIR
| style="background-color: white;"| Raadplegen afspraak slots bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakWijzigingsverzoekSturend
| style="background-color: white;"| EA-1.0.0-AWS-FHIR
| style="background-color: white;"| Sturen afspraak wijzigingsverzoek
|-
| style="background-color: white;" rowspan="4"| XIS
| style="background-color: white;"| AfspraakBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak aan de patiënt
|-
| style="background-color: white;"| AfspraakTypenBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ATB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak typen
|-
| style="background-color: white;"| AfspraakSlotsBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ASB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak slots
|-
| style="background-color: white;"| AfspraakWijzigingsverzoekOntvangend
| style="background-color: white;"| EA-1.0.0-AWO-FHIR
| style="background-color: white;"| Ontvangen afspraak wijzigingsverzoek van de patiënt.
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak wijzigen (Totaal).png|Componenten diagram afspraak wijzigen]]

'''Componenten diagram afspraak wijzigen'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="8"|[[MedMij:V2018.02_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakSlots (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakTypen (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak typen
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ATR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak typen
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ATB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakWijziging (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraak wijzigingsverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AWS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraak wijzigingsverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AWO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Afspraak wijzigen.png|Use case diagram afspraak wijzigen]]

'''Use case diagram afspraak wijzigen

=Functionaliteit=
-

=Verantwoordelijkheid voor informatie=
Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

=Infrastructuur=
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| AUTEUR(S)
| style="background-color: white;"| TITEL
| style="background-color: white;"| VERSIE
| style="background-color: white;"| DATUM
| style="background-color: white;"| BRON
| style="background-color: white;"| ORGANISATIE
|}
'''Referenties

MedMij:V2018.02 OntwerpZelfmetingen

2018-03-29T15:26:57Z

Marten Smits:

{{#customtitle:Use cases vitale functies en zelfmetingen }}

[[Bestand:Self-Measuements_zonder_tekst.png |link=|links |85px|Zelfmetingen]]
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.02_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.02_FHIR_VitalSigns|Technisch]]
desc none
</imagemap>

=Inleiding=
Deze pagina beschrijft use cases voor de patiënt in relatie tot zelfmetingen van vitale functies die een patiënt kan verzamelen en delen door middel van een PGO. De vitale functies van de mens zijn de lichaamsfuncties die de persoon vitaal of ook wel in leven houden, voorbeelden zijn ademhaling en circulatie (hartslag en bloeddruk).

Momenteel bestaat er geen standaard voor zelfmeet gegevens van de vitale functies. Het doel van deze pagina is om verschillende uitwisseling scenario's van zelfmeet gegevens met de patiënt te beschrijven voor gebruik in MedMij.

Zoals [[MedMij:V2018.02_Ontwerpen|op deze pagina]] aangegeven, gebruikt MedMij zorginformatiebouwstenen (ZIB's) als leidraad voor de inhoud van informatie uitwisseling. Voor uitwisseling van zelfmeet gegevens gaat het om de volgende ZIB's:

*Patiënt
*Ademhaling
*Bloeddruk
*Hartfrequentie
*Lichaamsgewicht
*Lichaamslengte
*Lichaamstemperatuur
*O2Saturatie
*Pijnscore
*Polsfrequentie

=Use Cases=
==Use case: Raadplegen metingen betreffende de vitale functies door patiënt==
===Doel en relevantie===
Het voor patiënten mogelijk maken regie op hun eigen gezondheid te nemen door inzicht te geven in de vitale functie meetwaarden die over henzelf gaan.
===Domein===
Metingen betreffende vitale functies in het domein van zorgaanbieders en patiënten.

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van de meetwaarden van vitale functies vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn.

====Raadplegen meetwaarden ====
Informatie elementen in de vraag om meetwaarden van vitale functies.

* Patient identificatienummer
* Periode (startdatum - einddatum)
* Type (soort meetwaarden, bijvoorbeeld bloeddruk)

Dit betreft de filtermogelijkheden (query paramaters) in de vraag om meetwaarden van de vitale functies.

====Beschikbaar stellen meetwaarden meetwaarden====
Informatie elementen in meetwaarden van vitale functies staan hieronder. Het betreffen de Zorginformatiebouwstenen die te vinden zijn op https://zibs.nl/wiki/ZIB_Hoofdpagina.

*Patiënt
*Ademhaling
*Bloeddruk
*Hartfrequentie
*Lichaamsgewicht
*Lichaamslengte
*Lichaamstemperatuur
*O2Saturatie
*Pijnscore
*Polsfrequentie

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil meetwaarden van vitale functies raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt meetwaarden van vitale functies beschikbaar
|}
'''Bedrijfsrollen Medicatieoverzicht'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity_Diagram_-_MVF_raadplegen.jpg|Activiteitendiagram Raadplegen Meetwaarden vitale functies]]

'''Activiteitendiagram Raadplegen meetwaarden vitale functies'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas van Beek vindt u [https://www.nictiz.nl/SiteCollectionDocuments/Overig/Casus_Thomas_van_Beek_MedMij.pdf hier]. Hieronder een voor Thomas relevante situatie waarbij het raadplegen van meetwaarden betreffende de vitale functie een rol speelt.

<blockquote>Voordat Thomas zijn consult bij de internist heeft om de resultaten door te spreken worden er een aantal andere waarden getest. Zijn gewicht en zijn bloeddruk worden opgemeten. De laboratoriumwaarden zijn al bekend voordat de internist ze aan Thomas mee kan delen. Alhoewel Thomas zoals gezegd zo min mogelijk met zijn ziekte bezig wil zijn, vindt hij de jaarlijkse controle heel belangrijk. Hij vindt het dan ook heel erg handig om de resultaten van de onderzoeken een dag van tevoren al in te zien in zijn PGO. Hij kan zich zo goed voorbereiden en zal niet meer verrast zijn over de resultaten als zijn internist deze voorlegt.</blockquote>

===='Patient journey' - Roos Dalstra ====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [https://www.nictiz.nl/SiteCollectionDocuments/Overig/Casus_Roos_Dalstra_MedMij.pdf hier]. Hieronder een voor Roos relevante situatie waarbij het raadplegen van meetwaarden betreffende de vitale functie een rol speelt.

<blockquote>Na het ontslag komt de informatie over de opnameperiode vanuit het ziekenhuis beschikbaar in de PGO, zodat zij een goed beeld heeft van haar opname en haar medicatie. Dit kan zij ook delen met haar naasten</blockquote>

Roos kan na haar opname haar vitale waarden gemeten in ziekenhuis raadplegen. Zo beschikt zij over deze informatie die ze als referentiewaarden kan gebruiken.

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het systeem van een zorgaanbieder (XIS) stelt de gevraagde meetwaarden van de vitale functies beschikbaar aan het systeem van een patiënt (PGO).
Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.
=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van vitale functie meetwaarden tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

De patiënt wil de meetwaarden van de vitale functies inzien en de zorgaanbieder stelt dit ook beschikbaar.
:Een patiënt kan steeds zelf het initiatief nemen om de meetwaarden op te halen, maar het is ook mogelijk dat een PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de beschrijving van deze use case geen verschil.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) stuurt meetwaarden van de vitale functies naar een XIS.
*Het systeem van de zorgaanbieder (XIS) ontvangt meetwaarden van de vitale functies op voor de patiënt.
*De zorgverlener gebruikt zijn systeem om de meetwaarden van de vitale functies in te zien.

=====Post conditie=====
De patiënt heeft de meetwaarden vitale functies geraadpleegd via de persoonlijke gezondheidsomgeving.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt.

Een PGO vervult de volgende systeemrol:
* MeetwaardenVitaleFunctiesRaadplegend Systeem in FHIR [MM-1.0.0-MVR-FHIR].

Een XIS vervult in deze use case de volgende systeemrol:
* MeetwaardenVitaleFunctiesBeschikbaarstellend Systeem in FHIR [MM-1.0.0-MVB-FHIR]

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_MVF_raadplegen_(Totaal).jpg|Componenten diagram]]

'''Componenten diagram'''

De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Meetwaarden Vitale Functies(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen meetwaarden vitale functies
|style="background-color: white;vertical-align:top;"|MM-1.0.0-MVR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2018.02_FHIR_VitalSigns|Meetwaarden vitale functies in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen meetwaarden vitale functies
|style="background-color: white;vertical-align:top;"|MM-1.0.0-MVB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_MVF_raadplegen.jpg|Use case diagram raadplegen meetwaarden vitale functies]]

'''Use case diagram

==Use case: Sturen zelfmetingen van de vitale functies door patiënt==
===Doel en relevantie===
Het voor patiënten mogelijk maken regie op hun eigen gezondheid te nemen door het kunnen delen van hun zelfmeet gegevens met de zorgverlener.
===Domein===
Zelfmetingen betreffende vitale functies in het domein van zorgaanbieders en patiënten.

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van de zelfmeetwaarden van vitale functies vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een zorgaanbiederssysteem (XIS) .
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn
====Sturen zelfmetingen====
Informatie elementen in zelfmetingen betreffende vitale functies staan hieronder. Het betreffen Zorginformatiebouwstenen die te vinden zijn op https://zibs.nl/wiki/ZIB_Hoofdpagina.

*Patiënt
*Ademhaling
*Bloeddruk
*Hartfrequentie
*Lichaamsgewicht
*Lichaamslengte
*Lichaamstemperatuur
*O2Saturatie
*Pijnscore
*Polsfrequentie

====Ontvangen zelfmetingen====
Het ontvangende systeem stuurt een ontvangstbevestiging van de zelfmetingen.

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil zelfmetingen van vitale functies sturen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Ontvangt zelfmetingen van vitale functies
|}
'''Bedrijfsrollen Medicatieoverzicht'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity_Diagram_-_MVF_sturen.jpg|Activiteitendiagram Raadplegen Meetwaarden vitale functies]]

'''Activiteitendiagram sturen zelfmetingen vitale functies'''

===Procesbeschrijving===
===='Patient journey' - Roos Dalstra ====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [https://www.nictiz.nl/SiteCollectionDocuments/Overig/Casus_Roos_Dalstra_MedMij.pdf hier].

Hieronder een voor Roos relevante situatie waarbij het sturen van zelfmetingen betreffende de vitale functie een rol speelt.

<blockquote>Sinds een aantal maanden maakt Roos gebruik van een online persoonlijke gezondheidsomgeving. Daarin houdt ze onder andere haar bloedglucosewaarden bij. Daarnaast moet ze zich dagelijks wegen in verband met haar hartfalen. Bij hartfalen is de pompfunctie van het hart verminderd. Het hart pompt niet genoeg bloed rond, hierdoor kun je vocht vasthouden. Om dit te monitoren weegt Roos zich dagelijks, en houdt ze haar gewicht bij in haar persoonlijke gezondheidsomgeving. Wanneer haar gewicht toeneemt, dan krijgt ze een signaal vanuit haar PGO, omdat dit zou kunnen duiden op het vasthouden van vocht. Doordat Roos de huisarts toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld iets in de medicatie wordt gewijzigd, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug. De huisarts kan op zijn beurt de gegevens die Roos heeft ingevoerd bekijken, bijvoorbeeld met een handige grafiek die haar bloedsuikers over de afgelopen periode laat zien</blockquote>

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het systeem van een patiënt (PGO) stelt zelfmetingen van de vitale functies beschikbaar aan het systeem van een zorgaanbieder (XIS).
Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.
=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van zelfmetingen van de vitale functies tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

De zorgaanbieder wil de zelfmetingen van de vitale functies inzien en de patiënt stelt dit ook beschikbaar.
:Een patiënt kan steeds zelf het initiatief nemen om de meetwaarden te sturen, maar het is ook mogelijk dat een PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de beschrijving van deze use case geen verschil.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) stuurt zelfmetingen van de vitale functies naar een XIS.
*Het systeem van de zorgaanbieder (XIS) ontvangt en verwerkt de zelfmetingen van de patiënt.
*De zorgaanbieder gebruikt de het XIS om de zelfmetingen van de vitale functies in te zien.

=====Post conditie=====
De patiënt heeft zelfmetingen gestuurd via de persoonlijke gezondheidsomgeving.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt.

Een PGO vervult de volgende systeemrol:
* ZelfmetingenVitaleFunctiesSturend Systeem in FHIR [MM-1.0.0-ZVS-FHIR].

Een XIS vervult in deze use case de volgende systeemrol:
* ZelfmetingenVitaleFunctiesOntvangend Systeem in FHIR [MM-1.0.0-ZVO-FHIR]

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_MVF_sturen_(Totaal).jpg|Componenten diagram]]

'''Componenten diagram'''

De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Zelfmetingen Vitale Functies(PUSH)
|style="background-color: white;vertical-align:top;"|Sturen zelfmetingen van vitale functies
|style="background-color: white;vertical-align:top;"|MM-1.0.0-ZVS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen zelfmetingen vitale functies
|style="background-color: white;vertical-align:top;"|MM-1.0.0-ZVO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_MVF_sturen.jpg|Use case diagram sturen zelfmetingen vitale functies]]

'''Use case diagram

=Functionaliteit=
Er zijn geen aanwijzingen/eisen voor functionaliteit van de systemen.

=Verantwoordelijkheid voor informatie=
Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

=Infrastructuur=
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| AUTEUR(S)
| style="background-color: white;"| TITEL
| style="background-color: white;"| VERSIE
| style="background-color: white;"| DATUM
| style="background-color: white;"| BRON
| style="background-color: white;"| ORGANISATIE
|}
'''Referenties

MedMij:V2018.02 OntwerpPDFA

2018-03-29T15:26:45Z

Marten Smits:

{{#customtitle:Use Cases PDF/A}}

[[Bestand:PDF-A icoon.png |link=|links |87px|Medicatie Proces]]
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.02_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.02_FHIR_PDFA|Technisch]]
desc none
</imagemap>

=Inleiding=
Deze pagina beschrijft use cases waarbij een patiënt medische gegevens in de vorm van een PDF/A kan raadplegen en versturen met behulp van een persoonlijke gezondheidsomgeving. MedMij heeft het [https://nl.wikipedia.org/wiki/PDF/A PDF/A] format gekozen als uitwisseling voor ongestructureerde gezondheidsgegevens. Algemene informatie betreffende deze use cases kan gevonden worden op deze [https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.02_Ontwerpen wiki pagina].

=Use Cases=
Deze sectie vervolgt met de volgende use cases:
* [[MedMij:V2018.02_OntwerpPDFA#Use_case:_Raadplegen_medische_gegevens_in_PDF.2FA_door_pati.C3.ABnt | Raadplegen medische gegevens in PDF/A]]
* [[MedMij:V2018.02_OntwerpPDFA#Use_case:_Sturen_medische_gegevens_in_PDF.2FA_door_pati.C3.ABnt| Sturen medische gegevens in PDF/A]]
==Use case: Raadplegen medische gegevens in PDF/A door patiënt==
===Doel en relevantie===
Het voor patiënten mogelijk maken regie op hun eigen gezondheid te nemen door inzicht te geven in medische informatie die over henzelf gaan. Het is niet mogelijk om alle medische informatie direct gestructureerd te kunnen ontsluiten voor de patiënt. Dit ontwerp beschrijft het uitwisselen van ongestructureerde digitale informatie in een PDF/A format.

===Domein===
Documenten en ongestructureerde medische informatie in een PDF/A formaat in het domein van zorgaanbieders en patiënten.

===Context===
Het gaat om het elektronisch beschikbaar maken van medische gegevens in PDF/A formaat vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===

====Raadplegen medische gegevens in PDF/A====
Het raadplegen van een medische informatie gaat van een specifieke patiënt naar een specifieke organisatie in de zorg (bijvoorbeeld een zorgaanbieder).

Informatie elementen in de vraag om PDF/A documenten staan hieronder. Dit betreft de filtermogelijkheden (query paramaters) in de vraag om documentgegevens. Deze filermogelijkheden zijn afgeleid van het [http://wiki.ihe.net/index.php/Mobile_access_to_Health_Documents_(MHD) IHE MHD profiel].

*patient
*periode (startdatum - einddatum)
*auteur
*type document
*categorie
*status
*setting (aanvullende details over waar de content is gemaakt / specialisme)
*medische handelingen (belangrijkste uitgevoerde medische handelingen)

====Beschikbaar stellen medische gegevens in PDF/A ====
De informatie-elementen voor het beschikbaar stellen van een PDF/A worden beschreven in het [http://wiki.ihe.net/index.php/Mobile_access_to_Health_Documents_(MHD) IHE MHD profiel]. Dit betreft de inhoud van de transactie waarbij het om de volgende [http://hl7.org/fhir/STU3 HL7 FHIR STU3] informatie modellen en [https://zibs.nl/wiki/ZIB_Hoofdpagina Zorginformatiebouwstenen] gaat:

*HL7 FHIR
** [http://hl7.org/fhir/STU3/bundle.html Bundle]
** [http://hl7.org/fhir/STU3/documentmanifest.html DocumentManifest]
** [http://hl7.org/fhir/STU3/documentreference.html DocumentReference]
** [http://hl7.org/fhir/STU3/binary.html Binary]

*Zorginformatiebouwstenen
** [https://zibs.nl/wiki/Patient-v2.0.1(2015NL) Patient]
** [https://zibs.nl/wiki/Zorgverlener-v1.2.1(2015NL) Zorgverlener]

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil medische gegevens in PDF/A formaat raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt medische gegevens in PDF/A formaat beschikbaar
|}
'''Bedrijfsrollen afspraak inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - PDFA raadplegen.png|Activiteitendiagram PFD/A raadplegen]]

'''Activiteitendiagram PDF/A raadplegen'''

===Procesbeschrijving===
===='Patient journey' - Roos Dalstra ====
Het verhaal van de 'patient journey' van Roos vindt u [https://www.nictiz.nl/SiteCollectionDocuments/Overig/Casus_Roos_Dalstra_MedMij.pdf hier]. Hieronder een voor Roos relevante situatie waarbij het raadplegen van een PDF/A document rol speelt.

<blockquote> Na het ontslag komt de informatie over de opnameperiode vanuit het ziekenhuis beschikbaar in de PGO, zodat zij een goed beeld heeft van haar opname en haar medicatie. Dit kan zij ook delen met haar naasten.
</blockquote>

Roos zou in haar PGO bijvoorbeeld de ontslagbrief van haar opname kunnen opvragen.

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het systeem van een zorgaanbieder (XIS) stelt de PDF/A beschikbaar aan het systeem van een patiënt (PGO).
Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.
=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van medische gegevens in PDF/A tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

De patiënt wil zijn medische gegevens inzien en de zorgaanbieder stelt dit ook beschikbaar.
:Een patiënt kan steeds zelf het initiatief nemen om zijn medische gegevens op te halen, maar het is ook mogelijk dat een PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de beschrijving van deze use case geen verschil.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare medische gegevens bij een XIS aan de hand van een zoekopdracht.
*Het systeem van de zorgaanbieder (XIS) levert een lijst met metadata over de gevonden PDF/A documenten op voor de patiënt.
*De Patiënt gebruikt de persoonlijke gezondheidsomgeving om de gewenste PDF/A te raadplegen of te downloaden.
*Het systeem van de zorgaanbieder (XIS) levert de PDF/A op voor de patiënt.

=====Post conditie=====
De patiënt heeft zijn medische gegevens geraadpleegd via de persoonlijke gezondheidsomgeving.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen hebben meerdere systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk.
De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="2"| PGO
| style="background-color: white;"| PDFAMetadataLijstRaadplegend
| style="background-color: white;"| MM-1.0.0-PLR-FHIR
| style="background-color: white;"| Raadplegen PDF/A metadata lijst bij zorgaanbieder
|-
| style="background-color: white;"| PDFARaadplegend
| style="background-color: white;"| MM-1.0.0-PDR-FHIR
| style="background-color: white;"| Raadplegen PDF/A document bij zorgaanbieder
|-
| style="background-color: white;" rowspan="2"| XIS
| style="background-color: white;"| PDFAMetadataLijstBeschikbaarstellend
| style="background-color: white;"| MM-1.0.0-PLB-FHIR
| style="background-color: white;"| Beschikbaar stellen PDF/A metadata lijst bij patient
|-
| style="background-color: white;"| PDFABeschikbaarstellend
| style="background-color: white;"| MM-1.0.0-PDB-FHIR
| style="background-color: white;"| Beschikbaar stellen PDF/A document bij patient
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - PDFA raadplegen (Totaal).png|Componenten diagram PDF/A raadplegen]]

'''Componenten diagram PDFA raadplegen'''

=== Transacties, transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|PDFA metadata lijst (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen PDF/A metadata lijst
|style="background-color: white;vertical-align:top;"|MM-1.0.0-PLR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="4"|[[MedMij:V2018.02_FHIR_PDFA|PDF/A in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen PDF/A metadata lijst
|style="background-color: white;vertical-align:top;"|MM-1.0.0-PLB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|PDFA (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen PDF/A
|style="background-color: white;vertical-align:top;"|MM-1.0.0-PDR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen PDF/A
|style="background-color: white;vertical-align:top;"|MM-1.0.0-PDB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - PDFA raadplegen.png|Use case diagram PDF/A raadplegen]]

'''Use case diagram PDF.A 

==Use case: Sturen medische gegevens in PDF/A door patiënt==
===Doel en relevantie===
Het voor patiënten mogelijk maken regie op hun eigen gezondheid te nemen door medische informatie te delen met zorgverleners. Het is niet mogelijk om alle medische informatie direct te kunnen gestructureerd te kunnen versturen. Dit ontwerp beschrijft het uitwisselen van ongestructureerde digitale informatie in PDF/A formaat.

===Domein===
Documenten en ongestructureerde medische informatie in een PDF/A format in het domein van zorgaanbieders en patiënten.

===Context===
Het gaat om het elektronisch beschikbaar maken van afspraken vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===

====Sturen van Medische gegevens in PDF/A====
Het sturen van een medische informatie gaat van een specifieke patiënt naar een specifieke organisatie in de zorg (bijvoorbeeld een zorgaanbieder).

De informatie-elementen voor het sturen van een PDF/A worden beschreven in het [http://wiki.ihe.net/index.php/Mobile_access_to_Health_Documents_(MHD) IHE MHD profiel]. Dit betreft de inhoud van de transactie waarbij het om de volgende [http://hl7.org/fhir/STU3 HL7 FHIR STU3] informatie modellen en [https://zibs.nl/wiki/ZIB_Hoofdpagina Zorginformatiebouwstenen] gaat:

*HL7 FHIR
** [http://hl7.org/fhir/STU3/bundle.html Bundle]
** [http://hl7.org/fhir/STU3/documentmanifest.html DocumentManifest]
** [http://hl7.org/fhir/STU3/documentreference.html DocumentReference]
** [http://hl7.org/fhir/STU3/binary.html Binary]

*Zorginformatiebouwstenen
** [https://zibs.nl/wiki/Patient-v2.0.1(2015NL) Patient]
** [https://zibs.nl/wiki/Zorgverlener-v1.2.1(2015NL) Zorgverlener]

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil medische gegevens in PDF/A formaat sturen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Ontvangt medische gegevens in PDF/A formaat
|}
'''Bedrijfsrollen afspraak inzien'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity Diagram - Sturen sturen.png|Activiteitendiagram PFD/A sturen]]

'''Activiteitendiagram PDF/A sturen'''

===Procesbeschrijving===
===='Patient journey' - Roos Dalstra ====
Het verhaal van de 'patient journey' van Roos vindt u [https://www.nictiz.nl/SiteCollectionDocuments/Overig/Casus_Roos_Dalstra_MedMij.pdf hier].

Hieronder een voor Roos relevante situatie waarbij het sturen van een PDF/A document rol kan spelen.
<blockquote>De internist in dienst die nacht wil graag weten welke medicatie Roos gebruikt. Aangezien Roos alles netjes heeft bijgehouden in haar persoonlijke
gezondheidsomgeving kan zij het ziekenhuis haar medicatiegegevens laten zien en laten uploaden naar het ziekenhuisinformatiesysteem. Hierdoor heeft de internist
een snel en accuraat overzicht van de huidige medicatie van Roos. </blockquote>

Wanneer een XIS niet in staat is om het medicatieoverzicht gestructureerd te ontvangen, zou het PGO het medicatieoverzicht in een PDF/A kunnen versturen. Zo heeft de arts wel gelijk de beschikking over het medicatieoverzicht.

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het systeem van een patiënt (PGO) stuurt de PDF/A naar het systeem van een zorgverlener (XIS).
Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.
=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van medische gegevens in PDF/A tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

De patiënt wil zijn medische gegevens inzien en de zorgaanbieder stelt dit ook beschikbaar.
:Een patiënt kan steeds zelf het initiatief nemen om zijn medische gegevens op te halen, maar het is ook mogelijk dat een PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de beschrijving van deze use case geen verschil.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) stuurt medische gegevens in PDF/A formaat naar een XIS.
*Het systeem van de zorgaanbieder (XIS) ontvangt een PDF/A van de patiënt.

=====Post conditie=====
De patiënt heeft zijn medische gegevens in PDF/A formaat verstuurd via de persoonlijke gezondheidsomgeving.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om afspraken van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| PDFASturend
| style="background-color: white;"| MM-1.0.0-PDS-FHIR
| style="background-color: white;"| Sturen PDF/A document naar zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| PDFAOntvangend
| style="background-color: white;"| MM-1.0.0-PDO-FHIR
| style="background-color: white;"| Ontvangen PDF/A document van de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - PDFA sturen (Totaal).png |Componenten diagram PDFA sturen]]

'''Componenten diagram PDF/A Sturen'''

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|PDFA (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen PDF/A
|style="background-color: white;vertical-align:top;"|MM-1.0.0-PDS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2018.02_FHIR_PDFA|PDF/A in FHIR]]

|-
|style="background-color: white;vertical-align:top;"|Ontvangen PDF/A
|style="background-color: white;vertical-align:top;"|MM-1.0.0-PDO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - PDFA sturen.png|Use case diagram PFD/A sturen]]

'''Use case diagram PDF/A sturen

=Functionaliteit=
Er zijn geen aanwijzingen/eisen voor functionaliteit van de systemen.

=Verantwoordelijkheid voor informatie=
Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

=Infrastructuur=
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| AUTEUR(S)
| style="background-color: white;"| TITEL
| style="background-color: white;"| VERSIE
| style="background-color: white;"| DATUM
| style="background-color: white;"| BRON
| style="background-color: white;"| ORGANISATIE
|}
'''Referenties

MedMij:V2018.02 OntwerpMedicatie

2018-03-29T15:26:32Z

Marten Smits:

{{#customtitle:Use Cases Medicatieproces|Use Cases Medicatieproces }}

[[Bestand:Medicatie_proces_Icoon.png |link=|links |85px|Medicatie Proces]]
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.02_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.02_FHIR_MedicationProcess|Technisch]]
desc none
</imagemap>

=Inleiding=
Deze pagina beschrijft use cases voor de patiënt in relatie tot de [https://www.nictiz.nl/Paginas/Medicatieproces.aspx informatiestandaard Medicatieproces] (MP). Deze use cases zijn gebaseerd op versie 9.x van deze standaard. Deze standaard beschrijft de uitwisseling met de patiënt nog niet expliciet. Het doel van deze pagina is om de verschillende uitwisselingsscenario's van medicatiegegevens met de patiënt toe te voegen.

Het is het streven van het MedMij-programma om deze beschrijvingen toe te voegen aan de bestaande standaard voor Medicatieproces.

Zoals [[MedMij:V1.0 Ontwerpen|op deze pagina]] aangegeven, gebruikt MedMij voor medicatiegegevens de bouwstenen uit de informatiestandaard Medicatieproces versie 9.x als leidraad voor de uitwisseling van informatie. Voor uitwisseling van medicatiegegevens gaat het om de volgende ZIB's:

*Patiënt;
*Zorgaanbieder;
*Zorgverlener;
*Medicatieafspraak;
*Verstrekkingsverzoek;
*Toedieningsafspraak;
*Verstrekking;
*Medicatiegebruik;
*Toediening.

=Use Cases=

==Use case: Raadplegen medicatieoverzicht door patiënt==
===Doel en relevantie===
Het voor patiënten mogelijk maken regie op hun eigen gezondheid te nemen door inzicht te geven in medicatiegegevens die over henzelf gaan.
===Domein===
Medicatiegegevens in het domein van zorgaanbieders en patiënten.

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van een medicatieoverzicht vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn gedefinieerd in ART-DECOR.
====Raadplegen medicatieoverzicht====
Informatie elementen in de vraag om medicatieoverzicht staan hieronder. Om deze informatie in een nieuwe tab te openen, klik [http://decor.nictiz.nl/medicatieproces/mp-html-20170829T141253/tr-2.16.840.1.113883.2.4.3.11.60.20.77.4.147-2016-11-08T103441.html hier].

Dit betreft de filtermogelijkheden (query paramaters) in de vraag om medicatieoverzicht.

<html>
<iframe width="100%" height="500" src=https://decor.nictiz.nl/medicatieproces/mp-html-20170829T141253/tr-2.16.840.1.113883.2.4.3.11.60.20.77.4.147-2016-11-08T103441.html frameborder="0" align="middle"></iframe>
</html>

====Beschikbaarstellen medicatieoverzicht====
Informatie elementen in medicatieoverzicht staan hieronder. Om deze informatie in een nieuwe tab te openen, klik [http://decor.nictiz.nl/medicatieproces/mp-html-20170829T141253/tr-2.16.840.1.113883.2.4.3.11.60.20.77.4.148-2016-11-08T103441.html hier].

Dit betreft de inhoud van het medicatieoverzicht.

<html>
<iframe width="100%" height="500" src=https://decor.nictiz.nl/medicatieproces/mp-html-20170829T141253/tr-2.16.840.1.113883.2.4.3.11.60.20.77.4.148-2016-11-08T103441.html frameborder="0" align="middle"></iframe>
</html>

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil medicatieoverzicht raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt medicatieoverzicht beschikbaar
|}
'''Bedrijfsrollen Medicatieoverzicht'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity_Diagram_-_Medicatieoverzicht.jpg|Activiteitendiagram Raadplegen Medicatieoverzicht]]

'''Activiteitendiagram Raadplegen Medicatieoverzicht'''

===Procesbeschrijving===
===='Patient journey' - Roos Dalstra ====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [https://www.nictiz.nl/SiteCollectionDocuments/Overig/Casus_Roos_Dalstra_MedMij.pdf hier].

Hieronder een aantal voor Roos relevante situaties waarbij het raadplegen van een medicatieoverzicht een rol speelt.

<blockquote>De afgelopen weken is Roos aan het tobben met haar gezondheid, ze houdt vocht vast achter haar longen en voelt zich niet goed. Haar gewicht begint toe te nemen en haar bloedsuikers zijn niet meer stabiel, en ze maakt een afspraak bij haar huisarts, dokter Jacobs, op 16 juli. Deze verhoogt na onderzoek haar vochtafdrijvende medicatie iets, en geeft haar een nieuw schema waarin staat hoeveel insuline zij extra moet spuiten als de bloedglucosewaarden boven een bepaalde waarde komen. Deze medicatiewijzigingen worden ook zichtbaar in een vernieuwd medicatieoverzicht van huisartsenpraktijk Jacobs/Kroonen, die de situatie op 16 juli weergeeft. Dit medicatieoverzicht kan zij inzien in haar persoonlijke gezondheidsomgeving. Dit geeft haar grip op haar situatie, ze weet waar zij aan toe is.</blockquote>

<blockquote>Het gaat slechter met Roos en op een nacht wordt ze erg benauwd wakker, daarnaast is ze duizelig. Ondanks aanpassingen van de medicatie neemt de benauwdheid niet af, het wordt eerder erger. Joost, haar man, neemt daarom contact op met de huisartsenpost en na overleg wordt besloten dat Roos naar het ziekenhuis moet komen. Een ambulance haalt haar op. Diezelfde nacht nog wordt ze opgenomen op de afdeling cardiologie van het Epidaurus ziekenhuis. Roos blijft een aantal weken onder behandeling en langzaam verbetert haar situatie. Roos wordt op 23 augustus ontslagen uit het Epidaurus ziekenhuis. Haar medicatie is gedurende haar opname verschillende keren aangepast. Bij ontslag maakt de ziekenhuisapotheker een op dat moment actueel medicatieoverzicht voor Roos. Dit medicatieoverzicht maakt het apothekerssysteem beschikbaar voor de persoonlijke gezonheidsomgeving van Roos. Roos kan nu via haar PGO dit medicatieoverzicht van 23 augustus van het Epidaurus ziekenhuis bekijken. Dit geeft haar meer grip op haar gezondheidssituatie.</blockquote>

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het systeem van een zorgaanbieder (XIS) stelt een medicatieoverzicht beschikbaar aan het systeem van een patiënt (PGO).
Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.
=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van medicatieoverzichten tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

De patiënt wil het medicatieoverzicht inzien en de zorgaanbieder stelt dit ook beschikbaar.
:Een patiënt kan steeds zelf het initiatief nemen om een medicatieoverzicht op te halen, maar het is ook mogelijk dat een PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de beschrijving van deze use case geen verschil.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om een medicatieoverzicht bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert een medicatieoverzicht op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om het medicatieoverzicht in te zien.

=====Post conditie=====
De patiënt heeft het medicatieoverzicht geraadpleegd via de persoonlijke gezondheidsomgeving.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt.

Een XIS vervult in deze use case de volgende systeemrol:
* MedicatieoverzichtBeschikbaarstellend Systeem in FHIR [MP-9.0.4-MOB-FHIR].

Een PGO vervult de volgende systeemrol:
* MedicatieoverzichtRaadplegend Systeem in FHIR [MP-9.0.4-MOR-FHIR].

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Medicatieoverzicht (Totaal).jpg|Componenten diagram]]

'''Componenten diagram'''

De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Medicatieoverzicht (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen medicatieoverzicht
|style="background-color: white;vertical-align:top;"|MP-9.0.4-MOR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2018.02_FHIR_MedicationProcess|Medicatieoverzicht in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen medicatieoverzicht
|style="background-color: white;vertical-align:top;"|MP-9.0.4-MOB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Medicatiegegevens.jpg|Use case diagram raadplegen Medicatiegegevens]]

'''Use case diagram

==Use case: Raadplegen medicatiegegevens door patiënt==
===Doel en relevantie===
Het voor patiënten mogelijk maken regie op hun eigen gezondheid te nemen door inzicht te geven in medicatiegegevens die over henzelf gaan.
===Domein===
Medicatiegegevens in het domein van zorgaanbieders en patiënten.

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van een medicatiegegevens vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn gedefinieerd in de informatiestandaard voor Medicatieproces.
====Raadplegen medicatiegegevens====
Informatie elementen in de vraag om medicatiegegevens staan hieronder. Om deze informatie in een nieuwe tab te openen, klik [http://decor.nictiz.nl/medicatieproces/mp-html-20170829T141253/tr-2.16.840.1.113883.2.4.3.11.60.20.77.4.136-2016-07-12T133747.html hier].

Dit betreft de filtermogelijkheden (query paramaters) in de vraag om medicatiegegevens.

<html>
<iframe width="100%" height="500" src=https://decor.nictiz.nl/medicatieproces/mp-html-20170829T141253/tr-2.16.840.1.113883.2.4.3.11.60.20.77.4.136-2016-07-12T133747.html frameborder="0" align="middle"></iframe>
</html>

====Beschikbaarstellen medicatiegegevens====
Informatie elementen in medicatiegegevens staan hieronder. Om deze informatie in een nieuwe tab te openen, klik [http://decor.nictiz.nl/medicatieproces/mp-html-20170829T141253/tr-2.16.840.1.113883.2.4.3.11.60.20.77.4.102-2016-03-23T163243.html hier].

Dit betreft de inhoud van de transactie met medicatiegegevens.

<html>
<iframe width="100%" height="500" src=https://decor.nictiz.nl/medicatieproces/mp-html-20170829T141253/tr-2.16.840.1.113883.2.4.3.11.60.20.77.4.102-2016-03-23T163243.html frameborder="0" align="middle"></iframe>
</html>

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil medicatiegegevens raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt medicatiegegevens beschikbaar
|}
'''Bedrijfsrollen Medicatiegegevens'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity_Diagram_-_Medicatiegegevens.jpg|Activiteitendiagram Raadplegen Medicatiegegevens]]

'''Activiteitendiagram Raadplegen Medicatiegegevens'''

===Procesbeschrijving===
===='Patient journey' - Roos Dalstra ====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [https://www.nictiz.nl/SiteCollectionDocuments/Overig/Casus_Roos_Dalstra_MedMij.pdf hier].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van een medicatiegegevens een rol speelt.

<blockquote>Roos heeft de afgelopen tijd in verband met haar hartfalen en diabetes diverse wijzigingen in haar medicatie gehad. Dit is soms gedaan door de specialist en soms door de huisarts. De apotheker paste dan daarna ook soms de doseerinstructies aan, omdat er een ander product geleverd moest worden dan voorgeschreven was. Eigenlijk is Roos het overzicht een beetje kwijtgeraakt. Gelukkig heeft haar PGO wel de mogelijkheid om bij al haar zorgverleners medicatiegegevens op te vragen. Haar PGO kan dit aan haar presenteren in een overzichtelijk geheel. Roos kan nu controleren of ze al haar medicatie inneemt conform de laatste afspraken die hierover zijn gemaakt. Dit is voor Roos heel geruststellend.</blockquote>

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het systeem van een zorgaanbieder (XIS) stelt een medicatiegegevens beschikbaar aan het systeem van een patiënt (PGO).
Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.
=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van medicatiegegevens tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

De patiënt wil medicatiegegevens inzien en de zorgaanbieder stelt dit ook beschikbaar.
:Een patiënt kan steeds zelf het initiatief nemen om een medicatiegegevens op te halen, maar het is ook mogelijk dat een PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de beschrijving van deze use case geen verschil.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare medicatiegegevens bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert medicatiegegevens op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om medicatiegegevens in te zien.

=====Post conditie=====
De patiënt kan medicatiegegevens inzien via de persoonlijke gezondheidsomgeving.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatiegegevensen van zorgaanbieder naar patiënt.

Een XIS vervult in deze use case de volgende systeemrol:
* Medicatiegegevenseschikbaarstellend Systeem in FHIR [MP-9.0.4-MGB-FHIR]

Een PGO vervult de volgende systeemrol:
* MedicatiegegevensRaadplegend Systeem [MP-9.0.4-MGR-FHIR].

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Medicatiegegevens (Totaal).jpg|Componenten diagram]]

'''Componenten diagram'''

De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Link naar technische specificatie'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Medicatiegegevens (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen medicatiegegevens
|style="background-color: white;vertical-align:top;"|MP-9.0.4-MGR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2018.02_FHIR_MedicationProcess|Medicatiegegevens in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen medicatiegegevens
|style="background-color: white;vertical-align:top;"|MP-9.0.4-MGB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use Case Diagram - Medicatieoverzicht.jpg|Use case diagram raadplegen Medicatieoverzicht]]

'''Use case diagram

=Functionaliteit=
Er zijn geen aanwijzingen/eisen voor functionaliteit van de systemen.

=Verantwoordelijkheid voor informatie=
Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

=Infrastructuur=
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| AUTEUR(S)
| style="background-color: white;"| TITEL
| style="background-color: white;"| VERSIE
| style="background-color: white;"| DATUM
| style="background-color: white;"| BRON
| style="background-color: white;"| ORGANISATIE
|}
'''Referenties

MedMij:V2018.02 OntwerpLabresult

2018-03-29T15:26:04Z

Marten Smits:

{{#customtitle:Use Cases MedMij Laboratoriumresultaten}}

[[Bestand:Labresultaten_icoon.png |link=|links |87px|MedMij_|Laboratoriumresultaten]]
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.02_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.02_FHIR_LaboratoryResults|Technisch]]
desc none
</imagemap>

=Inleiding=
Deze pagina beschrijft use cases voor de patiënt met relatie tot de [https://www.nictiz.nl/standaardisatie/informatiestandaarden/laboratoria informatiestandaard labuitwisseling] (LAB).

Door IHE / Antilope is ook al werk gedaan voor beschrijving use cases voor uitwisseling van laboratoriumgegevens, deze zijn [https://usecase-repository.ihe-europe.net/use-cases?field_domain_value=LAB&field_scale_value=All&field_source_value=All hier] gepubliceerd. Op het moment van schrijven van deze documentatie heeft IHE twee verschillende use cases beschreven:
* Uitwisseling voor een laboratorium binnen een ziekenhuis: [https://usecase-repository.ihe-europe.net/content/request-and-results-distribution-workflow-laboratory-within-hospital Request and results distribution workflow for laboratory within a hospital]
* Nationale / regionale uitwisseling tussen zorgaanbieders / laboratoria: [https://usecase-repository.ihe-europe.net/content/request-and-results-sharing-workflow-laboratory-nationalregional-scale Request and results sharing workflow for laboratory on a National/regional scale]

Bovenstaande standaarden beschrijven de uitwisseling met de patiënt nog niet expliciet. Het doel van deze pagina is om de verschillende uitwisselingsscenario's van laboratoriumgegevens met de patiënt toe te voegen.

Het is het streven van het MedMij-programma om deze beschrijvingen toe te voegen aan de bestaande informatiestandaard Labuitwisseling.

Zoals [[MedMij:V2018.02_Ontwerpen|op deze pagina]] aangegeven, gebruikt MedMij de BGZ en de bijbehorende ZIB's als leidraad voor de uitwisseling van informatie. Voor uitwisseling van laboratoriumresultaten gaat het om de volgende ZIB's:
*Patiënt;
*Zorgaanbieder;
*Zorgverlener;
*OverdrachtLaboratoriumUitslag.

=Use Cases=

==Use case: Raadplegen laboratoriumresultaten in persoonlijke gezondheidsomgeving==
===Doel en relevantie===
Het voor patiënten mogelijk maken regie op hun eigen gezondheid te nemen door inzicht te geven in laboratoriumresultaten die over henzelf gaan.
===Domein===
Laboratoriumgegevens in het domein van zorgaanbieders, laboratoria en patiënten.

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van laboratoriumresultaten vanuit zorgaanbieder / laboratorium naar een patiënt. De zorgaanbieder / laboratorium is dus de bron van de gegevens.

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
====Raadplegen laboratoriumresultaten====
Informatie-elementen in de vraag om laboratoriumresultaten zijn:
*periode (startdatum - einddatum) waarop het laboratoriumresultaat uitgevoerd was.

Dit betreft de filtermogelijkheden (query paramaters) in de vraag om laboratoriumresultaten.

====Beschikbaarstellen laboratoriumresultaat====
De volgende zorginformatiebouwstenen definiëren de informatie-elementen die van toepassing zijn:
*Patiënt
*Zorgverlener
*Zorgaanbieder
*OverdrachtLaboratoriumUitslag v1.2.2

Informatie elementen in OverdrachtLaboratoriumUitslag staan [https://zibs.nl/wiki/OverdrachtLaboratoriumUitslag-v1.2.2(2015NL) hier].

Dit betreft de inhoud van ieder laboratoriumresultaat.

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil laboratoriumresultaten raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder / Laboratorium
|style="background-color: white;vertical-align:top;"|Stelt laboratoriumresultaten beschikbaar
|}
'''Bedrijfsrollen Laboratoriumresultaten'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity_Diagram_-_LaboratoriumResultaten.jpg|Activiteitendiagram Raadplegen laboratoriumresultaten ]]

'''Activiteitendiagram Raadplegen laboratoriumresultaten'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas van Beek vindt u [https://www.nictiz.nl/SiteCollectionDocuments/Overig/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een aantal voor Thomas relevante situaties waarbij het raadplegen van laboratoriumresultaten een rol speelt.

<blockquote>Eens per drie maanden heeft Thomas een controle in het ziekenhuis. Hij heeft dan een afspraak met afwisselend de internist of de diabetesverpleegkundige. Thomas moet een half uur voor zijn afspraak al aanwezig zijn in het ziekenhuis om bloed te laten prikken. Een waarde die onder andere bepaald wordt is de HbA1c waarde, hieraan is te zien wat de gemiddelde glucosewaarde over de afgelopen 3 maanden geweest is. De uitslag is binnen een half uur binnen. De zorgverlener vertelt Thomas de laboratoriumresultaten en wat die betekenen tijdens de afspraak. Het ziekenhuis informatiesysteem maakt de laboratoriumresultaten ook beschikbaar voor de persoonlijke gezondheidsomgeving van Thomas. Thomas kan de resultaten dan ook later nog eens nakijken als hij dat wil. Dit geeft hem meer grip op zijn gezondheidssituatie.</blockquote>

<blockquote>In april is het tijd voor de jaarlijkse, uitgebreide controle in het ziekenhuis in verband met diabetes. De controle zélf zal plaatsvinden op 12 april. Thomas moet een week daarvoor, op 5 april, bloed prikken en urine afgeven in het ziekenhuis. De resultaten van de laboratoriumonderzoeken moeten beschikbaar zijn vóór 12 april. Het ziekenhuis informatiesysteem heeft de resultaten beschikbaar gemaakt voor Thomas op 10 april. Thomas wil zich goed op zijn afspraak voorbereiden en raadpleegt op 11 april, via zijn PGO, deze laboratoriumresultaten. Hij krijgt zo vooraf al meer inzicht in zijn situatie. Zijn nierwaarden lijken hem afwijkend. Hij vraagt zich daarom af of de instelling van de medicatie misschien aangepast moet worden. Voor de zekerheid noteert hij deze vraag voor zijn internist. Zo kan hij goed voorbereid naar het ziekenhuis op 12 april.</blockquote>

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het uitwisselen van laboratoriumresultaten tussen zorgaanbieder / laboratorium en patiënt.
Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.
=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van laboratoriumresultaten tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

Er is een laboratoriumresultaat dat de patiënt wil raadplegen en dat de zorgaanbiederzorgaanbieder / laboratorium beschikbaar stelt.
:Soms zijn er valide redenen om bepaalde laboratoriumresultaten tijdelijk nog niet beschikbaar te stellen aan de patiënt. Bijvoorbeeld omdat de zorgverlener deze eerst zelf wil interpreteren en/of er eerst met de patiënt over wil spreken.
:Een patiënt kan steeds zelf het initiatief nemen om laboratoriumresultaten op te halen, maar het is ook mogelijk dat een PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze use case beschrijving geen verschil.

=====Proces stappen=====
*De patiënt vraagt om laboratoriumresultaten bij een zorgaanbieder / laboratorium.
*De zorgaanbieder / laboratorium levert laboratoriumresultaten op voor de patiënt.
*Patiënt ziet de laboratoriumresultaten in.

=====Post conditie=====
De patiënt heeft laboratoriumresultaten gezien.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder / laboratorium als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder / laboratorium)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om laboratoriumresultaten van zorgaanbieder / laboratorium naar patiënt.

Een XIS vervult in deze use case de volgende systeemrol:
* LaboratoriumresultaatBeschikbaarstellend Systeem [LAB-1.0.0-LRB-FHIR]

Een PGO vervult de volgende systeemrol:
* LaboratoriumresultaatRaadplegend Systeem [LAB-1.0.0-LRR-FHIR].

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_LaboratoriumResultaten_(Totaal).jpg|Componenten diagram]]

'''Componenten diagram'''

De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Laboratoriumresultaten (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen laboratoriumresultaten
|style="background-color: white;vertical-align:top;"|LAB-1.0.0-LRR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2018.02_FHIR_LaboratoryResults|Laboratoriumresultaten in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen laboratoriumresultaten
|style="background-color: white;vertical-align:top;"|LAB-1.0.0-LRB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder (laboratorium)
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_LaboratoriumResultaten.jpg|Use case diagram raadplegen laboratoriumresultaten]]

'''Use case diagram

=Functionaliteit=
Er zijn geen aanwijzingen/eisen voor functionaliteit van de systemen.

=Verantwoordelijkheid voor informatie=
Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

=Infrastructuur=
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| AUTEUR(S)
| style="background-color: white;"| TITEL
| style="background-color: white;"| VERSIE
| style="background-color: white;"| DATUM
| style="background-color: white;"| BRON
| style="background-color: white;"| ORGANISATIE
|}
'''Referenties

MedMij:V2018.02 OntwerpHuisartsgegevens

2018-03-29T15:25:38Z

Marten Smits:

{{#customtitle:Use Cases Huisartsgegevens}}

[[Bestand:Huisartsgegevens.png|link=|links|Huisartsgegevens|85px]]
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.02_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.02_FHIR GP Data|Technisch]]
desc none
</imagemap>

=Inleiding=
De basis voor de inhoud van dit ontwerp is de "[[#richtlijn-huisarts-patient|Richtlijn online inzage in het H-EPD door patiënt]]". Op basis van deze richtlijn wordt de patiënt in staat gesteld een samenvatting van zijn huisartsdossier online op te vragen.

==Use case: Raadplegen Huisartsgegevens door patiënt==
===Doel en relevantie===
Online inzage door de patiënt in het elektronisch patiëntendossier bij de huisarts (H-EPD) heeft als doel om de zorg beter te maken. De patiënt krijgt door online inzage meer overzicht en is beter geïnformeerd. Hierdoor heeft de patiënt meer begrip van en regie over de eigen gezondheid en het stimuleert zelfzorg. Ook kan het de kwaliteit van het dossier helpen verhogen.

===Domein===
Huisartsgegevens in het domein van zorgaanbieders en patiënten.

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van een huisartsgegevens vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De gegevens zoals deze door de huisarts worden aangeboden voor online inzage aan de patiënt bestaan uit 10 secties (zie bijlage 1 van de richtlijn). Een aantal daarvan overlappen met de [[MedMij:V2018.02 OntwerpBGZ|Basisgegevensset Zorg]] (BgZ) en een aantal daarvan zijn uniek voor het huisartsdossier. De richtlijn baseert zich op het [[#his-referentiemodel-2016|HIS referentiemodel]]. Die richtlijn heeft geen relatie met de [http://www.zibs.nl Zorginformatiebouwstenen] (ZIB's). Voor een aantal secties is deze relatie wel te leggen en voor een aantal ook niet (goed). De discrepanties zullen in de toekomst, in het Nictiz/NHG project "Huisartsoverdrachten", nog verder onderzocht en geslecht worden. Dit ontwerp Huisartsgegevens loopt daarop vooruit, omdat alle FHIR-profielen zich baseren op de ZIB's. Dit ontwerp en de technische uitwerking zal worden bijgewerkt, zodra de geharmoniseerde zorginformatiebouwstenen beschikbaar zijn. Dit zal naar verwachting niet vóór 2019 plaatsvinden.

In de MedMij FHIR implementatiegids staat de technische representatie van de betreffende ZIBs in zogenaamde FHIR profielen. In onderstaand overzicht is te zien welk FHIR profiel bij welke ZIB hoort.

{| class="wikitable collapsible collapsed" cellpadding="10" width="80%"
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="4" | Bijlage 1 Richtlijn Online inzage in het H-EPD door patiënt
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="2" | (Voorlopige) mapping naar ZIB's
|-
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| #
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| Onderdelen uit het Huisarts‑EPD
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| Beschrijving
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| Uitleg met voorbeelden
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| Zorginformatiebouwsteen
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| Opmerking
|-
| style="background-color: white;vertical-align:top;"| 1
| style="background-color: white;vertical-align:top;"|Huisarts/Huisartsenpraktijk
| style="background-color: white;vertical-align:top;"|De huisarts en/of de huisartsenpraktijk waar de gegevens van afkomstig zijn.
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"| [https://zibs.nl/wiki/Zorgverlener-v3.1(2017NL) Zorgverlener v3.1 (2017)] [https://zibs.nl/wiki/Zorgaanbieder-v3.1(2017NL) Zorgaanbieder v3.1 (2017)]
| style="background-color: white;vertical-align:top;"|
|-
| style="vertical-align:top;"| 2
| style="vertical-align:top;"|Patiënt
| style="vertical-align:top;"|De patiëntgegevens van de patiënt waarvoor de samenvatting is.
| style="vertical-align:top;"|
| style="vertical-align:top;"| [https://zibs.nl/wiki/Patient-v3.1(2017NL) Patient v3.1 (2017)]
| style="vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"| 3
| style="background-color: white;vertical-align:top;"|Episodes
| style="background-color: white;vertical-align:top;"|Een gezondheidsprobleem zoals een klacht of een aandoening, waarvan de aard in de loop der tijd kan veranderen door voortschrijdend inzicht of door het beloop van de aandoening.
| style="background-color: white;vertical-align:top;"|Ziekten, aandoeningen, klachten en symptomen. Bijvoorbeeld: blaasontsteking of droge hoest.
| style="background-color: white;" rowspan="3"| [https://zibs.nl/wiki/OverdrachtConcern-v1.2(2015NL) OverdrachtConcern v1.2 (2015)] [https://zibs.nl/wiki/Alert-v3.1(2017EN) Alert v3.1 (2017)]
| style="background-color: white;" rowspan="3"| Na 2015 is nog een versie 3.0 in 2016 uitgebracht die alleen in versie, niet in inhoud veranderd is. De versie van 2017 echter heeft expliciet gebruik voor episodes geschrapt.
|-
| style="vertical-align:top;"| 4
| style="vertical-align:top;"|Episodes met een attentievlag
| style="vertical-align:top;"|Episodes kunnen een attentievlag hebben om extra aandacht voor de episode te vragen. De attentievlag kan aanwezig blijven als een episode afgesloten wordt/is, wanneer de gebruiker het belangrijk vindt dit probleem in beeld te houden.
| style="vertical-align:top;"|Belangrijke ziekten, aandoeningen, klachten en symptomen. Bijvoorbeeld: reuma, suikerziekte, kanker, erfelijke ziekten.
|-
| style="background-color: white;vertical-align:top;"| 5
| style="background-color: white;vertical-align:top;"|Open en gesloten episodes
| style="background-color: white;vertical-align:top;"|Episodes kunnen open (actueel) of gesloten (niet langer actueel) zijn.
| style="background-color: white;vertical-align:top;"|Open/actueel: ziekten, aandoeningen, klachten en symptomen waarvoor nog zorg wordt verleend. Gesloten/niet actueel: ziekten, aandoeningen, klachten en symptomen waarvoor in het verleden zorg is verleend.
|-
| style="vertical-align:top;"| 6
| style="vertical-align:top;"|Behandeling
| style="vertical-align:top;"|Handeling aan de patiënt, die invloed heeft op de gezondheidstoestand van de patiënt.
| style="vertical-align:top;"|Operaties en (zware) behandelingen zoals bestraling of chemotherapie.
| style="vertical-align:top;"| ''[https://zibs.nl/wiki/Verrichting-v4.0(2017NL) Verrichting v4.0 (2017)]''
| style="vertical-align:top;"| ZIB ondersteunt alleen de DHD Verrichtingenthesaurus waarmee het huisartssysteem niet werkt.
|-
| style="background-color: white;vertical-align:top;"| 7
| style="background-color: white;vertical-align:top;"| Profylaxe en voorzorg
| style="background-color: white;vertical-align:top;"| In Profylaxe en voorzorg worden voorzorgsmaatregelen vastgelegd die nodig zijn bij of vanwege bepaalde medische aandoeningen.
| style="background-color: white;vertical-align:top;"| Bijvoorbeeld voorzorgen bij ooit doorgemaakte endocarditis (ontsteking van de binnenbekleding van het hart en de hartkleppen) of na een miltverwijdering.
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"| Er is in principe slechts een type uit NHG tabel 56
|-
| style="vertical-align:top;"| 8
| style="vertical-align:top;"| Actuele medicatie
| style="vertical-align:top;"| Medicatie-afspraak Het voorstel van een voorschrijver tot gebruik van medicatie waarmee de patiënt akkoord is. De afspraak kan zowel starten, herhalen, wijzigen als stoppen van medicatie betreffen.
| style="vertical-align:top;"| '''De actuele medicatie''' is het overzicht van de medicatieafspraken. Het is de lijst van geneesmiddelen die de patiënt nu gebruikt.
| style="vertical-align:top;"| [https://zibs.nl/wiki/Medicatieafspraak-v1.0(2017NL) Medicatieafspraak v1.0 (2017)]
| style="vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"| 9
| style="background-color: white;vertical-align:top;"| Medicatie-overgevoeligheid
| style="background-color: white;vertical-align:top;"| Een medicatie-overgevoeligheid beschrijft een overgevoeligheid van een patiënt voor een geneesmiddel, een stof of een geneesmiddelengroep, waarmee rekening gehouden moet worden bij het voorschrijven van medicatie.
| style="background-color: white;vertical-align:top;"| Lijst van geneesmiddelen waarop in het verleden een overgevoeligheid of levensbedreigende allergische reactie is opgetreden. Bijvoorbeeld: allergie voor aspirine.
| style="background-color: white;vertical-align:top;"| [https://zibs.nl/wiki/AllergieIntolerantie-v3.1(2017NL) AllergieIntolerantie v3.1 (2017)]
| style="background-color: white;vertical-align:top;"|
|-
| style="vertical-align:top;"| 10
| style="vertical-align:top;"|Correspondentie
| style="vertical-align:top;"|Inkomend: Een binnengekomen brief betreffende een patiënt, die als zodanig is vastgelegd in het medisch dossier van de patiënt. Uitgaand: Een brief die opgesteld is door een praktijkmedewerker en naar een externe zorgverlener verstuurd is.
| style="vertical-align:top;"|Inkomende = brieven uit het ziekenhuis, polikliniek, zorginstelling. Uitgaande = verwijsbrieven.
| style="vertical-align:top;"| ''[https://zibs.nl/wiki/TekstUitslag-v4.0(2017NL) TekstUitslag v4.0 (2017)]''
| style="vertical-align:top;"| Correspondentie kan een binair bestand zijn zoals PDF/A, typen in de ZIB zijn niet toereikend voor alle typen correspondentie
|-
| style="background-color: white;vertical-align:top;"| 11
| style="background-color: white;vertical-align:top;"|Resultaten van bepalingen – ''laatste veertien maanden''
| style="background-color: white;vertical-align:top;"|Een bepaling is een objectiveerbare diagnostische verrichting. Het resultaat is de (uitkomst) van een bepaling.
| style="background-color: white;vertical-align:top;"|Uitslagen van fysieke metingen, zoals bloeddruk, gewicht en laboratoriumtesten, zoals ijzergehalte in het bloed.
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/LaboratoriumUitslag-v4.0(2017NL) LaboratoriumUitslag v4.0 (2017)] 
[https://zibs.nl/wiki/Bloeddruk-v3.1(2017NL) Bloeddruk v3.1 (2017)] 
[https://zibs.nl/wiki/Lichaamsgewicht-v3.1(2017NL) Lichaamsgewicht v3.1 (2017)] 
[https://zibs.nl/wiki/Lichaamslengte-v3.1(2017NL) Lichaamslengte v3.1 (2017)] 
[https://zibs.nl/wiki/Lichaamstemperatuur-v3.1(2017NL) Lichaamstemperatuur v3.1 (2017)] 
[https://zibs.nl/wiki/AlgemeneMeting-v3.0(2017NL) AlgemeneMeting v3.0 (2017)] 
[https://zibs.nl/wiki/Hartfrequentie-v3.1(2017NL) Hartfrequentie v3.1 (2017)] 
[https://zibs.nl/wiki/O2Saturatie-v3.1(2017NL) O2Saturatie v3.1(2017)] 
[https://zibs.nl/wiki/Polsfrequentie-v3.1(2017NL) Polsfrequentie v3.1(2017)]
| style="background-color: white;vertical-align:top;"|
|-
| style="vertical-align:top;"| 12
| style="vertical-align:top;"|E- en P-regels van de SOEP- structuur - ''vastgelegd na invoering van online inzage''
| style="vertical-align:top;"|Informatie uit een deelcontact dat in vrije tekst wordt geregistreerd volgens de SOEP-structuur. Het acroniem SOEP staat voor Subjectief, Objectief, Evaluatie en Plan.
| style="vertical-align:top;"|In de E(valuatie)-regel staat de conclusie van het consult. In de P(lan)-regel staan de afgesproken zaken en eventuele vervolgstappen.
| style="vertical-align:top;"| ''[https://zibs.nl/wiki/TekstUitslag-v4.0(2017NL) TekstUitslag v4.0 (2017)]''
| style="vertical-align:top;"| Journaalregeltype en ICPC-codering, extra t.o.v. in ZIB
|}

====Raadplegen huisartsgegevens ====
De vraag wordt gesteld aan de huisarts of huisartsenpraktijk. Er zijn geen verdere parameters bekend. Zie de [[#richtlijn-huisarts-patient|richtlijn]] voor de verdere context van de vraag naar de huisartsgegevens.

Dit betreft de filtermogelijkheden (parameters) in de vraag om huisartsgegevens.

====Beschikbaar stellen huisartsgegevens====
Zie voor de Informatie-elementen in huisartsgegevens de [[#richtlijn-huisarts-patient|richtlijn]].

Dit betreft de inhoud van de transactie met huisartsgegevens.

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" cellpadding="10" width="50%
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil huisartsgegevens raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt huisartsgegevens beschikbaar
|}
'''Bedrijfsrollen huisartsgegevens'''

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity_Diagram_-_Huisartspatientsamenvatting.jpg|Activiteitendiagram Raadplegen huisartsgegevens]]

'''Activiteitendiagram Raadplegen huisartsgegevens'''

===Procesbeschrijving===
===='Patient journey' - Roos Dalstra ====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u in de [https://www.nictiz.nl/SiteCollectionDocuments/Overig/Casus_Roos_Dalstra_MedMij.pdf casus Roos Dalstra].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van de huisartsgegevens een rol speelt.

<blockquote></blockquote>

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het systeem van een zorgaanbieder (XIS) stelt huisartsgegevens beschikbaar aan het systeem van een patiënt (PGO).
Deze paragraaf vervolgt met een beschrijving van precondities, processtappen, en postcondities.
=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van huisartsgegevens tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

De patiënt wil de huisartsgegevens inzien en de zorgaanbieder stelt deze ook beschikbaar.
:Een patiënt kan steeds zelf het initiatief nemen om een huisartsgegevens op te halen, maar het is ook mogelijk dat een PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de beschrijving van deze use case geen verschil.

=====Processtappen=====
*Het systeem van de patiënt (PGO) vraagt om de beschikbare huisartsgegevens bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de huisartsgegevens op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om de huisartsgegevens in te zien.

=====Postconditie=====
De patiënt kan de huisartsgegevens inzien via de persoonlijke gezondheidsomgeving.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om de gegevens van zorgaanbieder naar patiënt.

Een PGO vervult de volgende systeemrol:
* HuisartsPatiëntsamenvattingRaadplegend Systeem [MM-1.0.0-HGR-FHIR].

Een XIS vervult in deze use case de volgende systeemrol:
* HuisartsPatiëntsamenvattingBeschikbaarstellend Systeem in FHIR [MM-1.0.0-HGB-FHIR]

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Huisartspatientsamenvatting_(Totaal).jpg|Componentendiagram]]

'''Componentendiagram'''

De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

=== Transacties, Transactiegroepen en systeemrollen===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Link naar technische specificatie'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Huisartsgegevens (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen huisartsgegevens
|style="background-color: white;vertical-align:top;"|MM-1.0.0-HGR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2018.02_FHIR GP Data|Huisartsgegevens in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaar stellen huisartsgegevens
|style="background-color: white;vertical-align:top;"|MM-1.0.0-HGB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Huisartspatientsamenvatting.jpg|Use case diagram raadplegen Huisartsgegevens]]

'''Use case diagram

=Functionaliteit=
Er zijn geen aanwijzingen/eisen voor functionaliteit van de systemen.

=Verantwoordelijkheid voor informatie=
Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

=Infrastructuur=
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| Richtlijn Online inzage in het H-EPD door patiënt
| style="background-color: white;"|
| style="background-color: white;"| 2017
| style="background-color: white;"| https://www.nhg.org/themas/publicaties/richtlijn-online-inzage-het-h-epd-door-patient of de [https://www.nhg.org/sites/default/files/content/nhg_org/images/richtlijn_online_inzage_in_het_h-epd_door_patient_web_2017.pdf directe link (PDF)]
| style="background-color: white;"| NHG / Patiëntenfederatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| HIS referentiemodel Publieksversie (Utrecht 2016)
| style="background-color: white;"|
| style="background-color: white;"| 2016
| style="background-color: white;"| https://referentiemodel.nhg.org/inhoud/themas/publieksversie/published
| style="background-color: white;"| NHG
|}
'''Referenties

MedMij:V2018.02 OntwerpAllergieIntolerantie

2018-03-29T15:25:16Z

Marten Smits:

{{#customtitle:Functioneel Ontwerp AllergieIntolerantie}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:Allergie.png |link=|links |87px|Medicatie Proces]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.02_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.02_FHIR_AllergyIntolerance|Technisch]]
desc none
</imagemap>

=Inleiding=
Deze pagina beschrijft het functioneel ontwerp voor het raadplegen van allergie en intolerantie gegevens door een patiënt. De overkoepelende inleiding van de MedMij functionele ontwerpen kan [[MedMij:V2018.02_Ontwerpen| hier]] gevonden worden. Dit functioneel ontwerp is een toevoeging op de informatie standaard [https://www.nictiz.nl/standaardisatie/informatiestandaarden/medicatieveiligheid Medicatieveiligheid]. In [https://informatiestandaarden.nictiz.nl/wiki/mp:V6.12.3_Ontwerp_medicatieproces#Transactie_Condities_opvragen Medicatieproces v6.12.x] wordt beschreven hoe allergie en intolerantie gegevens tussen zorgverleners uitgewisseld worden. Dit ontwerp beschrijft hoe de patiënt deze gegevens in een PGO kan inzien.

Voor uitwisseling van allergie en intolerantie gegevens worden de volgende ZIB's gebruikt:

* Patiënt;
* Zorgaanbieder;
* Zorgverlener;
* AllergieIntolerantie.

=Use Cases=
==Use case 1: Raadplegen allergie- en intolerantiegegevens in persoonlijke gezondheidsomgeving==
=== Doel en relevantie ===
Het voor patiënten mogelijk maken regie op hun eigen gezondheid te nemen door inzicht te geven in de geregistreerde allergieën en intoleranties die over henzelf gaan.

=== Domein ===
Allergie en intolerantie gegevens in het domein van zorgaanbieders en patiënten.

=== Context ===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van de allergie en intolerantiegegevens vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie,
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.

De beschrijving is infrastructuur-onafhankelijk.

=== Informatie ===

====Raadplegen allergie en intolerantie gegevens====
Informatie elementen in de vraag om allergy en intolerantie gegevens staan hieronder. Om deze informatie in een nieuwe tab te openen, klik [https://decor.nictiz.nl/medicatieproces/mp-html-20170829T141253/tr-2.16.840.1.113883.2.4.3.11.60.20.77.4.70-2013-08-07T000000.html hier].

* PatientIdentificatienummer
* Periode (startdatum - einddatum)
* Zorgverleners specialisme

Dit betreft de filtermogelijkheden (query paramaters) in de vraag om allergie en intolerantie gegevens. Meest waarschijnlijk is dat bij het raadplegen van allergie en intolerantie gegevens gevraagd wordt om alle gegevens behorende bij de patiënt.

<html>
<iframe width="100%" height="500" src=https://decor.nictiz.nl/medicatieproces/mp-html-20170829T141253/tr-2.16.840.1.113883.2.4.3.11.60.20.77.4.70-2013-08-07T000000.html frameborder="0" align="middle"></iframe>
</html>

====Beschikbaarstellen AllergieIntolerantiegegevens====
De volgende zorginformatiebouwstenen definiëren de informatie-elementen die van toepassing zijn:
*Patiënt
*Zorgverlener
*Zorgaanbieder
*AllergieIntolerantie

Informatie elementen voor het beschikbaar stellen van allergie en intolerantie gegevens staan hieronder. Om deze informatie in een nieuwe tab te openen, klik [https://decor.nictiz.nl/medicatieproces/mp-html-20170829T141253/tr-2.16.840.1.113883.2.4.3.11.60.20.77.4.71-2013-08-07T000000.html hier].

Dit betreft de inhoud van de transactie opleveren van allergie en intolerantiegegevens.

<html>
<iframe width="100%" height="500" src=https://decor.nictiz.nl/medicatieproces/mp-html-20170829T141253/tr-2.16.840.1.113883.2.4.3.11.60.20.77.4.71-2013-08-07T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Bedrijfsrollen ===
Deze use case onderscheidt twee bedrijfsrollen, namelijk de ''Patiënt'' en de ''Zorgaanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10" width="100%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil zijn AllergieIntolerantie gegevens raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt AllergieIntolerantie gegevens beschikbaar
|}
'''Bedrijfsrollen Basisgegevensset Zorg'''

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_AllergieIntolerantiegegevens_.jpg|Activiteitendiagram Raadplegen AllergieIntolerantiegegevens]]

'''Activiteitendiagram Raadplegen AllergieIntolerantiegegevens'''

=== Procesbeschrijving ===
==== Patient journey - Roos Dalstra ====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [https://www.nictiz.nl/SiteCollectionDocuments/Overig/Casus_Roos_Dalstra_MedMij.pdf hier].

Hieronder een voor Roos relevante situaties waarbij het raadplegen van een haar allergie en intolerantie gegevens een rol speelt.

<blockquote>Doordat Roos de huisarts toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld iets in de medicatie wordt gewijzigd, dan ziet Roos dit in haar persoonlijke
gezondheidsomgeving terug. Maar ook oudere opgeslagen informatie kan roos raadplegen en opslaan in het PGO, zoals bijvoorbeeld haar bloeduitslagen en bekende allergieën.</blockquote>

<blockquote>Aangezien Roos alles netjes heeft bijgehouden in haar persoonlijke gezondheidsomgeving kan zij het ziekenhuis haar medicatiegegevens laten zien en laten uploaden naar het ziekenhuisinformatiesysteem. Hierdoor heeft de internist een snel en accuraat overzicht van de huidige medicatie van Roos. Ook heeft de internist inzicht in de hoeveelheid insuline die ze extra heeft gespoten toen haar bloedsuikers te hoog waren de afgelopen week. Roos autoriseert het ziekenhuis ook om haar laboratoriumwaarden in te zien, zo kunnen ze zien welke bloedwaarden ze de afgelopen tijd had. De internist merkt op dat Roos lichte verhoging heeft, en na onderzoek concludeert hij dat ze een blaasontsteking heeft. De internist ziet in het medicatieoverzicht van het PGO dat Roos allergisch is voor de antibiotica die meestal bij blaasontstekingen wordt gebruikt, waarna hij een ander middel voorschrijft. Doordat Roos eerder de allergie en intolerantie gegevens van haar bij haar huisarts heeft geraadpleegd was de internet op de hoogte van haar antibiotica allergie.</blockquote>

==== Proces ====
Het stuk van het proces waar het in deze use case omgaat is:
* Het systeem van een zorgaanbieder (XIS) stelt AllergieIntolerantie gegevens van de patiënt beschikbaar aan het systeem van een patiënt (PGO).

Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.

===== Preconditie =====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van de AllergieIntolerantie gegevens tussen het betreffende XIS en het eigen PGO.

De AllergieIntolerantie gegevens bestaat welke de persoon wil inzien en dat de zorgaanbieder beschikbaar wil stellen
:Een patiënt kan steeds zelf het initiatief nemen om de AllergieIntolerantie gegevens op te halen, maar het is ook mogelijk dat het PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze use case beschrijving geen verschil.

===== Proces stappen =====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare AllergieIntolerantie gegevens .
* Het systeem van de zorgaanbieder (XIS) maakt de AllergieIntolerantie gegevens beschikbaar voor de persoon.
* De persoon gebruikt het PGO om zijn AllergieIntolerantie gegevens in te zien.

===== Post conditie =====
De persoon kan zijn AllergieIntolerantie gegevens inzien via het PGO.

=== Systemen & Systeemrollen ===
Zowel de persoon als de zorgaanbieder maken ieder gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de allergie en intolerantie gegevens van zorgaanbieder naar de persoon. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

Het PGO van de persoon vervult de volgende systeemrol:
* AllergyIntolerantiegegevensRaadplegend Systeem in FHIR [MP-6.12.6-AIR-FHIR].

Het XIS van de zorgaanbieder vervult in deze use case de volgende systeemrol:
* AllergyIntolerantiegegevensBeschikbaarstellend Systeem in FHIR [MP-6.12.6-AIB-FHIR].

[[Bestand:Component_Diagram_-_AllergieIntolerantiegegevens_(Totaal).jpg|Componenten diagram]]

'''Componenten diagram van systemen en systeemrollen'''

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AllergieIntolerantie gegevens (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen AllergieIntolerantie gegevens
|style="background-color: white;vertical-align:top;"|MP-6.12.6-AIR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2018.02_FHIR_AllergyIntolerance|AllergieIntolerantie in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen AllergieIntolerantie gegevens
|style="background-color: white;vertical-align:top;"|MP-6.12.6-AIB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_AllergieIntolerantiegegevens_.jpg|Use case diagram inzien AllergieIntolerantiegegevens]]

'''Use case diagram inzien AllergieIntolerantiegegevens

=Functionaliteit=
Er zijn geen aanwijzingen/eisen voor functionaliteit van de systemen.

=Verantwoordelijkheid voor informatie=
Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

=Infrastructuur=
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| AUTEUR(S)
| style="background-color: white;"| TITEL
| style="background-color: white;"| VERSIE
| style="background-color: white;"| DATUM
| style="background-color: white;"| BRON
| style="background-color: white;"| ORGANISATIE
|}
'''Referenties

MedMij:V2018.02 FHIR eAfspraak

2018-03-29T15:25:02Z

Marten Smits:

{{#customtitle:MedMij FHIR Implementation Guide - eAfspraken}}

[[Bestand:EAfspraak_icoon_zonder_tekst.png |link=|links |87px|eAfspraken]]
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 03 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.02_OntwerpeAfspraken|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.02_FHIR_IG|Technisch]]
desc none
</imagemap>

__TOC__

=Introduction=
This page describes how patient can manage their health care related appointments in a MedMij context using the HL7 FHIR Standard. Initially this guide will contain information on how to request existing appointment information. Guidance on how to create, update, or cancel appointments will be available here as well in a later stage.
The functional requirements for this use case can be found [[MedMij:V2018.02_Ontwerpen|here]].

=Use case: retrieve appointments=
[[Bestand:Afsprakenstelsel-01.png|link=https://www.medmij.nl/afsprakenstelsel/|rechts |128px|Go to Afsprakenstelsel]]
{{FHIR-IG-Afsprakenstelsel-Note}}

==Introduction==
The goal of this use case is to give patients an overview of their appointments with all health care providers. The appointment information that is shared with the patient will contain start and end date/time, location, type of appointment, patient instructions, health care professionals present. Below is described how a PHR can retrieve this information and how a XIS should make this information available.

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Request appointments from the XIS
|-
|style="background-color: white;vertical-align:top;"|Healthcare professional (using a XIS)
|style="background-color: white;vertical-align:top;"|Serves appointments to the PHR
|}

==Invocations==
===Client - PHR===

====Search for appointments ====
The PHR system can request the appointments using individual search interactions. The search interaction searches for appointments based on start date/time. The interaction can be performed by an HTTP GET as shown:

<code>GET [base]/Appointment/?date=[date]</code>

for more information on how to query on dates using FHIR see [http://hl7.org/fhir/stu3/search.html#date| the FHIR search specification]

'''examples:'''

retrieve appointments from 01-01-2018 onwards:

<code>GET [base]/Appointment/?date=gt:2017-12-31</code>

retrieve appointments from 01-01-2018 until 01-03-2018

<code>GET [base]/Appointment/?date=ge:2018-01-01&date=lt:2018-03-01</code>

===Server - XIS===
Important sections of the FHIR specification for a server in this use case are the [http://hl7.org/fhir/STU3/http.html#2.21.0 RESTful API section] the [http://hl7.org/fhir/STU3/search.html search section].

====Response on search request====
If the search succeeds, the server SHALL return a 200 OK HTTP status code and the return content SHALL be a Bundle with type = searchset containing the results of the search as a collection of zero or more resources in a defined order. The result collection can be long, so servers may use paging. If they do, they SHALL use the method described below (adapted from RFC 5005 (Feed Paging and Archiving ) for breaking the collection into pages if appropriate. The server MAY also return an [http://hl7.org/fhir/operationoutcome.html OperationOutcome resource] within the searchset Bundle entries that contains additional information about the search; if one is sent it SHALL NOT include any issues with a fatal or error severity, and it SHALL be marked with a Bundle.entry.search.mode of outcome.

In order to allow the client to be confident about what search parameters were used as criteria by the server, the server SHALL return the parameters that were actually used to process the search. Applications processing search results SHALL check these returned values where necessary. For example, if the server did not support some of the filters specified in the search, a client might manually apply those filters to the retrieved result set, display a warning message to the user or take some other action.

Link to the relevant FHIR specification: http://hl7.org/fhir/STU3/http.html#search

====Handling errors====
If the search fails (cannot be executed, not that there is no matches), the return value is a status code 4xx or 5xx with an OperationOutcome. A HTTP status code of 403 signifies that the server refused to perform the search, while other 4xx and 5xx codes signify that some sort of error has occurred. When the search fails, a server SHOULD return an OperationOutcome detailing the cause of the failure. Note: An empty search result is not a failure.

In some cases, parameters may cause an error. For instance:

* A parameter may refer to a non-existent resource e.g. <code>GET [base]/Appointment?patient=101</code>, where "101" does not exist
* A parameter may refer to an unknown code e.g. <code>GET [base]/Appointment?appointment-type=83280</code>, where the 83280 is not known to the server
* A parameter may refer to a time that is out of scope e.g. <code>GET [base]/Appointment?date=le1995</code>, where the system only has data going back to 2001
* A data time parameter may have incorrect format e.g. <code>GET [base]/Appointment?date=23%20May%202009</code>
* A parameter may be unknown or unsupported
Where the content of the parameter is syntactically incorrect, servers SHOULD return an error. However, where the issue is a logical condition (e.g. unknown subject or code), the server SHOULD process the search, including processing the parameter - with the result of returning an empty search set, since the parameter cannot be satisfied.

In such cases, the search process MAY include an OperationOutcome in the search set that contains additional hints and warnings about the search process. This is included in the search results as an entry with search mode = outcome. Clients can use this information to improve future searches.

Common HTTP Status codes returned on FHIR-related errors (in addition to normal HTTP errors related to security, header and content type negotiation issues):

* 400 Bad Request - search could not be processed or failed basic FHIR validation rules
* 401 Not Authorized - authorization is required for the interaction that was attempted
* 404 Not Found - resource type not supported, or not a FHIR end-point

Link to relevant FHIR specification: http://hl7.org/fhir/STU3/search.html#errors

==Interactions, operations, search parameters==
===Interactions===
The following FHIR interactions are needed to retrieve appointment information:
* [http://hl7.org/fhir/STU3/http.html#search Search]

===Operations===
No operations are defined or needed for this transaction.

===Search parameters===
{| class="wikitable" width="1400px"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|Name||Type||Description||Expression
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| date
| [http://hl7.org/fhir/stu3/search.html#date date]
| Appointment date/time.
| Appointment.start
|-
|}

==Profiles==
{| class="wikitable" width="1400px"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|Name NL||Name EN||FHIR Resource||URL profile||Reference to section
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Patient
| #ZIB Patient|Patient
| Patient
| [https://simplifier.net/NictizSTU3/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_Patient | Patient]]
|-
| Zorgverlener
| HealthProfessional
| Practitioner
| [https://simplifier.net/NictizSTU3/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_HealthProfessional | HealthProfessional]]
|-
| Zorgaanbieder
| HealthcareProvider
| Organization
| [https://simplifier.net/NictizSTU3/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
| [[Bestand: Verwijzing.png| 20px]][[MedMij:V1.0_FHIR_HealthcareProvider | HealthcareProvider]]
|-
| Afspraak
| Appointment
| Appointment
| [https://simplifier.net/nictizstu3/eAfspraken-Appointment http://nictiz.nl/fhir/StructureDefinition/eAfspraken-Appointment]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V2018.02_FHIR_Appointment | Appointment]]
|-
|}

==Examples==

=Use case: book an appointment=

'''''NOTE: THIS USE CASE IS NOT YET SUPPORTED BY THE MEDMIJ "AFSPRAKENSTELSEL": CHANGES TO THE AFSPRAKENSTELSEL CAN INFLUENCE THE SPECIFICATION OF THIS USE CASE '''''

[[Bestand:Afsprakenstelsel-01.png|link=https://www.medmij.nl/afsprakenstelsel/|rechts |128px|Go to Afsprakenstelsel]]
{{FHIR-IG-Afsprakenstelsel-Note}}

==Introduction==
The goal of this use case is to allow patients to book an appointment at a certain selected health care provider. Below is described how a PHR can send an appointment request and how a XIS should handle this.

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Book appointment
|-
|style="background-color: white;vertical-align:top;"|Healthcare professional (using a XIS)
|style="background-color: white;vertical-align:top;"|Handles appointment request
|}

==Invocations==
===Client - PHR===

====Search for available slots ====
The PHR system can request available slots using the $find operation with optional input parameters on the Slot endpoint. This operation is a request for the XIS to calculate available slots, and provide a Bundle resources with available slots as return. The operation can be performed by an HTTP POST as shown:

<code>POST [base]/Slot/$find</code>

The optional input parameters can be put in the request body using the Parameters resource.

'''example body'''

<pre>
{
"resourceType": "Parameters",
"parameter": [
{
"name": "start",
"valueDateTime" : "2017-07-15T20:00:00Z"
},
{
"name": "end",
"valueDateTime" : "2017-07-17T20:00:00Z"
}
]
}
</pre>

A Bundle containing the available Slot resources and an optional [http://hl7.org/fhir/stu3/operationoutcome.html OperationOutcome] resource can be expected as return.

For more information on how operations work using FHIR see [http://hl7.org/fhir/stu3/operations.html the FHIR search specification]

====Book appointment====

After fetching open Slots, an Appointment resource is created by the Client Application and is exchanged with the EHR. This Appointment will be the parameter for the $book operation.
The operation can be performed by an HTTP POST as shown:

<code>POST [base]/Appointment/$book</code>

The proposed Appointment has to be put in the request body using the Parameters resource.

<pre>
{
"resourceType": "Parameters",
"parameter": [
{
"name": "appointment",
"resource": {
"resourceType": "Appointment",
--snip--
}
},
]
}
</pre>

A Bundle containing an required Appointment resource with status "booked" or "cancelled" and an optional [http://hl7.org/fhir/stu3/operationoutcome OperationOutcome] resource can be expected as return.

===Server - XIS===
Important sections of the FHIR specification for a server in this use case are the [http://hl7.org/fhir/STU3/http.html#2.21.0 RESTful API section] and the [http://hl7.org/fhir/STU3/operations.html operations section].

====Serve available slots ====
A Client can fetch available slots using the $find operation. (See client section above for details). A server is expected to answer this operation with a Bundle containing the available Slots based on the clients input parameters, and/or an optional OperationOutcome resource.

====Handle appointment booking request ====
A Client can propose an appointment to be booked using the $book operation. (See client section above for details). A server is expected to answer this operation with a Bundle containing the the proposed appointment with either a "booked" or "cancelled" status based on the XIS's internal logic. The server can also send an optional OperationOutcome resource, containing a "success" or "error" explaining the result.

====Response on operation request====
If an operation succeeds, an HTTP Status success code is returned. This will usually be a 2xx code, though it may also be a 303 See Other. Other kinds of 3xx codes should be understood to indicate that the operation did not proceed, and the client will need to re-issue the operation if it can perform the redirection (e.g. may get redirected to an authentication step). User agents should note that servers may issue redirects, etc. to authenticate the client in response to an operation request. An HTTP status code of 4xx or 5xx indicates an error, and an OperationOutcome SHOULD be returned with details.

In general, an operation response uses the [http://hl7.org/fhir/parameters.html Parameters] format whether there is only one or there are multiple named out parameters.
However, the defined <code>$find</code> operation only has one out parameters named "return". This means the parameters doesn't have to be used and the response is simply the resource itself. Which in this case is a [http://hl7.org/fhir/bundle.html Bundle] resource of type "search-response", containing the requested resources.

The resources that are returned by the operation may be retained and made available in the resource repository on the operation server. In that case, the server will provide the identity of the resource in the returned resources. When resources that are not persisted are returned in the response, they will have no id property.

Link to the relevant FHIR specification: http://hl7.org/fhir/stu3/operations.html

==Interactions, operations, search parameters==
===Interactions===
The following FHIR interactions are needed to retrieve avaialable slots information:
* [http://hl7.org/fhir/STU3/http.html#operations Operations]

===Operations===
* '''$find''' (Find available Slots): [https://simplifier.net/NictizSTU3/eafspraken-slot-find http://nictiz.nl/fhir/OperationDefinition/eafspraken-slot-find]

<html>
<iframe width="100%" height="500" src=https://www.simplifier.net/embed/render?id=NictizSTU3/eafspraken-slot-find frameborder="1" align="middle"></iframe></html>

* '''$book''' (Book Appointment): [https://simplifier.net/NictizSTU3/eafspraken-appointment-book http://nictiz.nl/fhir/OperationDefinition/eAfspraken-appointment-book]

<html>
<iframe width="100%" height="500" src=https://www.simplifier.net/embed/render?id=NictizSTU3/eafspraken-appointment-book frameborder="1" align="middle"></iframe></html>

==Profiles==
{| class="wikitable" width="1400px"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|Name NL||Name EN||FHIR Resource||URL profile||Reference to section
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Patient
| #ZIB Patient|Patient
| Patient
| [https://simplifier.net/NictizSTU3/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_Patient | Patient]]
|-
| Zorgverlener
| HealthProfessional
| Practitioner
| [https://simplifier.net/NictizSTU3/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_HealthProfessional | HealthProfessional]]
|-
| Zorgaanbieder
| HealthcareProvider
| Organization
| [https://simplifier.net/NictizSTU3/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
| [[Bestand: Verwijzing.png| 20px]][[MedMij:V1.0_FHIR_HealthcareProvider | HealthcareProvider]]
|-
| Afspraak
| Appointment
| Appointment
| [https://simplifier.net/nictizstu3/eAfspraken-Appointment http://nictiz.nl/fhir/StructureDefinition/eAfspraken-Appointment]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V2018.02_FHIR_Appointment | Appointment]]
|-
|-
| Slot
| Slot
| Slot
| [https://simplifier.net/nictizstu3/eAfspraken-Slot http://nictiz.nl/fhir/StructureDefinition/eAfspraken-Slot]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V2018.02_FHIR_Slot | Slot]]
|-
|}

==Examples==

=Use case: cancel/reschedule an appointment=

'''''NOTE: THIS USE CASE IS NOT YET SUPPORTED BY THE MEDMIJ "AFSPRAKENSTELSEL": CHANGES TO THE AFSPRAKENSTELSEL CAN INFLUENCE THE SPECIFICATION OF THIS USE CASE '''''

[[Bestand:Afsprakenstelsel-01.png|link=https://www.medmij.nl/afsprakenstelsel/|rechts |128px|Go to Afsprakenstelsel]]
{{FHIR-IG-Afsprakenstelsel-Note}}

==Introduction==
The goal of this use case is to allow patients to cancel a specific appointment. Below is described how a PHR can send a cancellation request and how a XIS should handle this.

'''Rescheduling is a combination of cancelling and re-booking an appointment. For booking an appointment, see the use case above.'''

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Cancel appointment
|-
|style="background-color: white;vertical-align:top;"|Healthcare professional (using a XIS)
|style="background-color: white;vertical-align:top;"|Handles cancellation request
|}

==Invocations==
===Client - PHR===

====Search for available slots ====
The PHR system can request the cancellation of a specific appointment using the $cancel operation with the appointment as input parameter on the Appointment endpoint. This operation is a request for the XIS to handle the request, and provide a Bundle resource with the Appointment resource (canceled or not) and an optional OperationOutcome slots as return. The operation can be performed by an HTTP POST as shown:

<code>POST [base]/Appointment/$cancel</code>

The optional input parameters can be put in the request body using the Parameters resource.

'''example body'''

<pre>
{
"resourceType": "Parameters",
"parameter": [
{
"name": "appointment",
"resource": {
"resourceType": "Appointment",
--snip--
}
},
]
}
</pre>

A Bundle containing the Appointment resources and an optional [http://hl7.org/fhir/stu3/operationoutcome.html OperationOutcome] resource can be expected as return.
If the appointment was indeed cancelled, the returned Appointment resource will have a status of "cancelled". If not, the Appointment will be returned as is, and a explanation will be returned in an OperationOutcome resource, with an explanation.

For more information on how operations work using FHIR see [http://hl7.org/fhir/stu3/operations.html the FHIR search specification]

===Server - XIS===
Important sections of the FHIR specification for a server in this use case are the [http://hl7.org/fhir/STU3/http.html#2.21.0 RESTful API section] and the [http://hl7.org/fhir/STU3/operations.html operations section].

====Handle appointment cancellation request ====
A Client can propose an appointment to be booked using the $cancel operation. (See client section above for details). A server is expected to answer this operation with a Bundle containing the proposed appointment either unchanged (if the request was denied) or with a "cancelled" status (if the request was approved) based on the XIS's internal logic. The server can also send an optional OperationOutcome resource, containing a "success" or "error" explaining the result.

====Response on operation request====
If an operation succeeds, a HTTP Status success code is returned. This will usually be a 2xx code, though it may also be a 303 See Other. Other kinds of 3xx codes should be understood to indicate that the operation did not proceed, and the client will need to re-issue the operation if it can perform the redirection (e.g. may get redirected to an authentication step). User agents should note that servers may issue redirects, etc. to authenticate the client in response to an operation request. An HTTP status code of 4xx or 5xx indicates an error, and an OperationOutcome SHOULD be returned with details.

In general, an operation response uses the [http://hl7.org/fhir/parameters.html Parameters] format whether there is only one or there are multiple named out parameters.
However, the defined <code>$cancel</code> operation only has one out parameters named "return". This means the parameters doesn't have to be used and the response is simply the resource itself. Which in this case is a [http://hl7.org/fhir/bundle.html Bundle] resource of type "search-response", containing the requested resources.

The resources that are returned by the operation may be retained and made available in the resource repository on the operation server. In that case, the server will provide the identity of the resource in the returned resources. When resources that are not persisted are returned in the response, they will have no id property.

Link to the relevant FHIR specification: http://hl7.org/fhir/stu3/operations.html

==Interactions, operations, search parameters==
===Interactions===
The following FHIR interactions are needed to retrieve avaialable slots information:
* [http://hl7.org/fhir/STU3/http.html#operations Operations]

===Operations===
* '''$cancel'' (Cancel Appointment): [https://simplifier.net/NictizSTU3/eAfspraken-appointment-cancel http://nictiz.nl/fhir/OperationDefinition/eAfspraken-appointment-cancel]

<html>
<iframe width="100%" height="500" src=https://www.simplifier.net/embed/render?id=NictizSTU3/eAfspraken-appointment-cancel frameborder="1" align="middle"></iframe></html>

==Profiles==
{| class="wikitable" width="1400px"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|Name NL||Name EN||FHIR Resource||URL profile||Reference to section
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Afspraak
| Appointment
| Appointment
| [https://simplifier.net/nictizstu3/eAfspraken-Appointment http://nictiz.nl/fhir/StructureDefinition/eAfspraken-Appointment]
| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V2018.02_FHIR_Appointment | Appointment]]
|-
|}

==Examples==

[[categorie:MedMij FHIR Use Cases]]

MedMij:V2018.02 FHIR VitalSigns

2018-03-29T15:24:48Z

Marten Smits:

{{#customtitle:MedMij FHIR use case Vital Signs}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:Self-measurements_Icoon.png|link=MedMij_VitalSigns|87px |links||Self-Measurements]]
<imagemap>Bestand:Leeswijzer-technisch-banner 03 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2018.02_OntwerpZelfmetingen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.02_FHIR_IG|Technisch]]
desc none
</imagemap>

__TOC__

=Introduction=
[[Bestand:Functioneel-02.png|link=MedMij:V2018.02_Ontwerpen |100px|rechts|Functional design|Go to functional design]]

This use case is mainly based on the HL7 FHIR vital signs specification - http://hl7.org/fhir/STU3/observation-vitalsigns.html. The HL7 FHIR vital signs specification is extended with profiles of ZIB concepts that represent vital signs. These profiles are derived from the official [http://hl7.org/fhir/observation-vitalsigns.html HL7 Vital Signs profiles]. The purpose of these profiles is to add additional concepts that are not in the vital sign profiles but are provided in the corresponding ZIB. Moreover, these derived profiles include ZIB to FHIR mappings.

'''Technical note:'''

Because the base [http://hl7.org/fhir/vitalsigns.html vital signs] profile constrains the <code>.code</code> and the <code>.component.code</code> to the datatype quantity it is not possible to add additional ZIB concepts. A GForge [https://gforge.hl7.org/gf/project/fhir/tracker/?action=TrackerItemEdit&tracker_item_id=13796 issue] is created to adress this problem. This issue will most likely be resolved with FHIR version STU4. However, to address this problem now the base vital signs panel is copied, the datatype constrain removed and published under a different canonical URL. The HL7 vital sign profiles bloodpressure, bodyweight and oxygensaturation are copied, the StructureDefinition.baseDefinition adjusted and published under a different canonical url because they are in the chain of derived profiles and the component.code need to be used for these vital signs.

Use cases:
* [[MedMij:V2018.02_FHIR_VitalSigns#Use_case:_Retrieve_Vital_Signs|Retrieve vital signs]]
* [[MedMij:V2018.02_FHIR_VitalSigns#Use_case:_Send_Vital_Signs|Send vital signs]]

=Actors involved=
{| class="wikitable"
! colspan="2" style="text-align:left;" | Persons
! colspan="2" style="text-align:left;" | Systems
! colspan="2" style="text-align:left;" | FHIR Capability Statements
|-
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
|-
| Patient
| The user of a personal healthcare enviorment.
| PHR
| Personal health record
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/NictizSTU3/vitalsigns-clientcapabilities CapabilityStatement: Client]
| Vital Signs client requirements
|-
| Healthcare professional
| The user of a XIS
| XIS
| Healthcare information system
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/NictizSTU3/vitalsigns-servercapabilities CapabilityStatement: Server]
| Vital Signs server requirements
|}

=Use case: Retrieve Vital Signs=
{{FHIR-IG-Afsprakenstelsel-Note}}

==Introduction==
The retrieve vital signs transaction is used by the PHR to retrieve vital signs from the XIS.

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transaction group'''
! style="text-align:left;"| '''Transaction'''
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;" rowspan="3"|Retrieve Vital Signs(PULL)
|style="background-color: white;vertical-align:top;"|Retrieve vital signs request
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Request vital signs from the XIS
|-
|style="background-color: white;vertical-align:top;"|Retrieve vital signs response
|style="background-color: white;vertical-align:top;"|Healthcare professional (using a XIS)
|style="background-color: white;vertical-align:top;"|Serves vital signs to the PHR
|}

==Invocations==
===PHR: request message===
The request message represents an HTTP GET parameterized query from the PHR to the XIS.

====Trigger Events====
When the patient(PHR) wants to obtain vital signs, it issues a retrieve vital signs request message.

====Message Semantics====
'''Search'''

The PHR executes an HTTP GET conform to the FHIR [http://hl7.org/fhir/http.html RESTfull] and [http://hl7.org/fhir/search.html search] specification against the XIS's Observation endpoint. This search query URL is configurable by the PHE and has the following format.

<pre>
GET [base]/Observation?[parameters]{&_format=[mime-type]}
</pre>

'''Search Parameters'''

The PHR may supply, and the XIS shall be capable of processing, all query parameters listed below. These search parameters are a selection of the defined search parameters by the HL7 FHIR specification search parameters of [http://hl7.org/fhir/STU3/observation.html#search Observation].

{| class="wikitable"
! colspan="3" style="font-weight: bold; text-align:left;" | Observation
|-
| style="font-weight: bold;" | Name
| style="font-weight: bold;" | Type
| style="font-weight: bold;" | Description
|-
| category
| token
| The classification of the type of observation
|-
| code
| token
| The code of the observation type
|-
| date
| date
| Obtained date/time. If the obtained element is a period, a date that falls in the period
|}

'''Example searches'''

The PHR should be able to fetch all of a patient's vital signs by searching on:
# category (all vital signs),
# category and date,
# code (specific vital sign),
# code and date.
<pre>1. GET [base]/Observation?category=vital-signs
2. GET [base]/Observation?category=vital-signs&date=[date]{&date=[date]}
3. GET [base]/Observation?code[vital sign LOINC{,LOINC2,LOINC3,...}]
4. GET [base]/Observation?code=[vital sign LOINC{,LOINC2,LOINC3,...}]&date=[date]{&date=[date]}
</pre>
The following table lists vital signs that have a corresponding ZIB. The column 'LOINC code' shows the LOINC code that can be used in the search query. Other possible codes, including the codes mentioned here, can be found [http://hl7.org/fhir/STU3/observation-vitalsigns.html#vitals-table here].

{| class="wikitable"
|-style="font-weight: bold; "
||ZIB ||LOINC code|| Reference to section
|-
|BloodPressure||85354-9|| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_BloodPressure | BloodPressure]]
|-
| BodyWeight||29463-7|| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_BodyWeight | BodyWeight]]
|-
| BodyHeight||8302-2|| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_BodyHeight | BodyHeight]]
|-
| BodyTemperature||8310-5|| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_BodyTemperature | BodyTemperature]]
|-
| Oxygenation, saturation, SpO2||59408-5|| [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_OxygenSaturation | OxygenSaturation]]
|-
| HeartRate||8867-4 || [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_HeartRate | HeartRate]]
|-
|}
=====Expected Actions=====
The XIS shall process the query to find and return the vital signs matching the provided query parameters.

===XIS: response message===
The XIS returns a HTTP Status code appropriate to the processing as well as a Bundle of matching vital signs Observation.

====Trigger Events====
The XIS completed processing of the retrieve vital signs request message.

====Message Semantics====
Based on the retrieve vital signs request message processing results, the XIS will either return an error or success. When the XIS needs to report an error, it shall use HTTP error response codes and shall include a FHIR OperationOutcome resource with more details on the failure. If the request message is processed successfully, whether or not a vital signs are found or generated, the HTTP status code shall be 200.

''Response Class:''
* Status 200: successful operation
* Status 400: invalid parameter
* Status 401/4xx: unauthorized request
* Status 403: insufficient scope

If the XIS is sending warnings, the Bundle resource shall also contain a FHIR OperationOutcome resource that contains those warnings. The FHIR specification describes the relevant sections:
*[http://hl7.org/fhir/STU3/observation-vitalsigns.html Vital Signs Profile]
*[http://hl7.org/fhir/STU3/http.html RESTful API framework]
*[http://hl7.org/fhir/STU3/search.html Search]
*[http://hl7.org/fhir/STU3/bundle.html Bundle resource]
*[http://hl7.org/fhir/STU3/operationoutcome.html OperationOutcome resource]

=====Message Resource content=====
The body of the response message shall be a Bundle of type 'searchset' containing all matching vital sign Observations as entries. If no Observations are found, a Bundle of type 'searchset' shall be returned without any Observation as entries.

In the table below, the vital sign ZIB's and their respective profiles are listed. Other vital signs profiles, withouth a corresponding ZIB are can be found in the [http://hl7.org/fhir/STU3/observation-vitalsigns.html HL7 FHIR specification.]

All returned resources to the PHR SHALL include their related profile canonical URL in the meta.profile element in order to show compliance. The Observation resources in the response message SHALL be a valid instance of these profiles.

{| class="wikitable"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|style="width:150px;"|ZIB name NL||style="width:150px;"|ZIB name EN||style="width:150px;"|FHIR Resource||style="width:400px;"|URL profile|| Reference to section
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Bloeddruk||BloodPressure||Observation||[https://simplifier.net/NictizSTU3/zib-BloodPressure http://nictiz.nl/fhir/StructureDefinition/zib-BloodPressure] || [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_BloodPressure | BloodPressure]]
|-
| LichaamsGewicht||BodyWeight||Observation||[https://simplifier.net/NictizSTU3/zib-BodyWeight http://nictiz.nl/fhir/StructureDefinition/zib-BodyWeight] || [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_BodyWeight | BodyWeight]]
|-
| LichaamsLengte||BodyHeight||Observation||[https://simplifier.net/NictizSTU3/zib-BodyHeight http://nictiz.nl/fhir/StructureDefinition/zib-BodyHeight] || [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_BodyHeight | BodyHeight]]
|-
| Lichaamstemperatuur||BodyTemperature||Observation||[https://simplifier.net/NictizSTU3/zib-BodyTemperature http://nictiz.nl/fhir/StructureDefinition/zib-BodyTemperature] || [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_BodyTemperature | BodyTemperature]]
|-
| O2Saturatie||oxygenation, saturation, SpO2||Observation||[https://simplifier.net/NictizSTU3/zib-OxygenSaturation http://nictiz.nl/fhir/StructureDefinition/zib-OxygenSaturation] || [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_OxygenSaturation | OxygenSaturation]]
|-
| Hartfrequentie||HeartRate||Observation||[https://simplifier.net/NictizSTU3/zib-HeartRate http://nictiz.nl/fhir/StructureDefinition/zib-HeartRate] || [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_HeartRate| HeartRate]]
|-
|}

====Expected Actions====
The PHE processes the results according to application-defined rules. The PHR should be robust as the response may contain medication information resources as mentioned in the former section.

==Interactions, operations, search parameters==
===Interactions===
The following logical interactions are needed for the retrieve medication information transaction:
* [http://hl7.org/fhir/STU3/http.html#search Search]

===Operations===
No operations are defined or needed for this transaction.

===Search parameters===
The following search parameter types and search result parameters need to be supported for this transaction.

Search parameter types:
* [http://hl7.org/fhir/STU3/search.html#token token]
* [http://hl7.org/fhir/STU3/search.html#date date]

=Use case: Send Vital Signs=
{{IssueBox|Currently, PUSH is not supported by 'the Afsprakenstelsel'. The below guidance is subject to change.}}
==Introduction==
The send vital signs transaction is used by the PHR to send vital signs to the XIS.

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transaction group'''
! style="text-align:left;"| '''Transaction'''
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;" rowspan="3"|Send Vital Signs(PUSH)
|style="background-color: white;vertical-align:top;"|Send vital signs request
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Sends vital signs to the XIS
|-
|style="background-color: white;vertical-align:top;"|Send vital signs response
|style="background-color: white;vertical-align:top;"|Healthcare professional (using a XIS)
|style="background-color: white;vertical-align:top;"|Receives vital signs from the PHR
|}

==Invocations==
===PHR: request message===
The send vital sings request message uses the HTTP POST method on the target XIS's base.

====Trigger Events====
This message is invoked when the PHR needs to send one or more vital signs observations to the XIS.

====Message Semantics====
Because sending vital signs will most likely consist of multiple Observations, a batch/transaction transaction is used. This allows for creating a set of resources in a single interaction.

A batch interaction is performed by an HTTP POST command as shown:

<pre>POST [base] {?_format=[mime-type]}</pre>

The body of the post submission is a Bundle with Bundle.type = batch. Each entry carries request details (Bundle.entry.request) that provides the HTTP details of the action in order to inform the system processing the batch or what to do for the entry (note: the request is optional, but SHOULD be present). Every bundle.entry creates a resource using an HTTP POST method. The resource of this entry shall be the vital sign observation.

'''Links:'''

* [http://hl7.org/fhir/STU3/http.html#transaction batch]
* [http://hl7.org/fhir/STU3/http.html#create create]

The vital signs data send to the XIS SHALL conform to the matching vital sign profile. The table below lists profiles that represent ZIBs that can be used for vital sign information exchange. If no matching vital sign ZIB profile is present, vital sign profiles listed in the [http://hl7.org/fhir/STU3/observation-vitalsigns.html FHIR specification] can be used. Other vital sign concepts are currently out of scope for this use case.

The resources in the response message SHALL be a valid instance of these profiles. All resources SHALL include their related profile canonical URL in the meta.profile element in order to show compliance.

{| class="wikitable" width="1200px"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|style="width:150px;"|ZIB name NL||style="width:150px;"|ZIB name EN||style="width:150px;"|FHIR Resource||style="width:400px;"|URL profile|| Reference to section
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Bloeddruk||BloodPressure||Observation||[https://simplifier.net/NictizSTU3/zib-BloodPressure http://nictiz.nl/fhir/StructureDefinition/zib-BloodPressure] || [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_BloodPressure | BloodPressure]]
|-
| LichaamsGewicht||BodyWeight||Observation||[https://simplifier.net/NictizSTU3/zib-BodyWeight http://nictiz.nl/fhir/StructureDefinition/zib-BodyWeight] || [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_BodyWeight | BodyWeight]]
|-
| LichaamsLengte||BodyHeight||Observation||[https://simplifier.net/NictizSTU3/zib-BodyHeight http://nictiz.nl/fhir/StructureDefinition/zib-BodyHeight] || [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_BodyHeight | BodyHeight]]
|-
| Lichaamstemperatuur||BodyTemperature||Observation||[https://simplifier.net/NictizSTU3/zib-BodyTemperature http://nictiz.nl/fhir/StructureDefinition/zib-BodyTemperature] || [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_BodyTemperature | BodyTemperature]]
|-
| O2Saturatie||oxygenation, saturation, SpO2||Observation||[https://simplifier.net/NictizSTU3/zib-OxygenSaturation http://nictiz.nl/fhir/StructureDefinition/zib-OxygenSaturation] || [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_OxygenSaturation | OxygenSaturation]]
|-
| Hartfrequentie||HeartRate||Observation||[https://simplifier.net/NictizSTU3/zib-HeartRate http://nictiz.nl/fhir/StructureDefinition/zib-HeartRate] || [[Bestand: Verwijzing.png| 20px]] [[MedMij:V1.0_FHIR_HeartRate | HeartRate]]
|-
|}

=====Expected Actions=====
On receipt of the submission, the XIS shall validate the resources and respond with an appropriate HTTP code. If the XIS encounters any errors or if validation fails, the XIS shall return an error as documented in the Message Semantics of the response message.

===XIS: response message===
The XIS returns a HTTP Status code appropriate to the processing outcome and returns a Bundle, of type batch-response, that contains one entry for each entry in the request, in the same order, with the outcome of processing the entry.

====Trigger Events====
The XIS completed processing of the send vital signs request message.

====Message Semantics====
The XIS SHALL return a Bundle with type set to batch-response that contains one entry for each entry in the request, in the same order, with the outcome of processing the entry.

A client may use the returned Bundle to track the outcomes of processing the entry, and the identities assigned to the resources by the server. Each entry element SHALL contain a response element which details the outcome of processing the entry - the HTTP status code, and the location and ETag header values, which are used for identifying and versioning the resources. In addition, a resource may be included in the entry, as specified by the Prefer header.

When the resource syntax or data is incorrect or invalid, and cannot be used to create a new resource, the server returns a 400 Bad Request HTTP status code. When the server rejects the content of the resource because of business rules, the server returns a 422 Unprocessable Entity error HTTP status code. In either case, the server SHOULD include a response body containing an OperationOutcome with detailed error messages describing the reason for the error.

Common HTTP Status codes returned on FHIR-related errors (in addition to normal HTTP errors related to security, header and content type negotiation issues):

* 400 Bad Request - resource could not be parsed or failed basic FHIR validation rules
* 404 Not Found - resource type not supported, or not a FHIR end-point
* 422 Unprocessable Entity - the proposed resource violated applicable FHIR profiles or server business rules. This should be accompanied by an OperationOutcome resource providing additional detail

Read more:
[http://hl7.org/fhir/STU3/http.html#create create]
[http://hl7.org/fhir/STU3/http.html#transaction batch]

====Expected Actions====
The PHE processes the results according to application-defined rules.

==Interactions, operations, search parameters==
===Interactions===
The following logical interactions are needed for the retrieve medication information transaction:
* [http://hl7.org/fhir/STU3/http.html#create create]
* [http://hl7.org/fhir/STU3/http.html#transaction batch/transaction]

===Operations===
No operations are defined or needed for this transaction.

===Search parameters===
No search parameters are defined or needed for this transaction.

[[categorie:MedMij FHIR Use Cases]]