Brontekst bekijken van MedMij:V2019.01 OntwerpBGZ 2017

{{#customtitle:Functioneel Ontwerp BgZ 2.1.4 (op basis van zibs release 2017)}}
{{MedMij:V2019.01_Issuebox}}

[[Bestand:BGZ_icoon.png |link=|links |87px|Use case BgZ|Patient Summary (BgZ)]] 
[[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:V2019.01_Ontwerpen|Functioneel]]                
circle 1787 230 212 [[MedMij:V2019.01_FHIR_BGZ_2017|Technisch]]                
desc none                    
</imagemap>


=Inleiding= 

==Algemeen==
Deze pagina beschrijft het functioneel ontwerp voor de Basisgegevensset Zorg binnen MedMij. De algemene inleiding van de MedMij functionele ontwerpen kan [[MedMij:V2019.01_Ontwerpen| hier]] gevonden worden.

De [https://www.registratieaandebron.nl/wat-is-registreren-aan-de-bron/de-kern-van-registreren-aan-de-bron/basisgegevensset/ Basisgegevensset Zorg], ofwel BgZ, is de minimale set van patiëntgegevens die specialisme, ziektebeeld en beroepsgroep overstijgend relevant is en die van belang is voor de continuïteit van zorg. Deze set aan patiëntgegevens wordt door alle zorgverleners hetzelfde vastgelegd. Hierdoor wordt uitwisseling van deze gegevens mogelijk gemaakt. De BgZ is gespiegeld aan de Europese Patient Summary. 

De bekende use cases voor het uitwisselen van de BgZ zijn gericht op uitwisseling tussen zorgverleners voor spoedeisende hulp of ongeplande zorg. Tot op heden is uitwisseling vanuit het perspectief van de patiënt niet beschreven. Het doel van deze pagina is om de uitwisseling van de BgZ met de patiënt toe te voegen.

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

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

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

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

==Kwalificatie==
{{#lst:MedMij:V2019.01_Kwalificatie|medmij_kwalificatie_introductie}}

===Specifieke informatie over deze kwalificatie===
Specifieke informatie over de kwalificatie van de transacties 'Raadplegen BgZ' en 'Beschikbaarstellen BgZ' is te vinden in [[MedMij:V2019.01_ToelichtingKwalificatieBgZ|Toelichting Kwalificatie BgZ]].

=Use Cases=
==Use case 1: Raadplegen Basisgegevensset Zorg in persoonlijke gezondheidsomgeving==
=== Doel en relevantie ===
Het voor patiënten mogelijk maken regie op hun eigen gezondheid te nemen door inzicht te geven in gegevens uit de Basisgegevensset Zorg (BgZ) die over henzelf gaan.

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

=== Context ===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van de BgZ 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 [https://www.registratieaandebron.nl/pdf/BgZ_specificatie_obv_zibs_2017_v1.1.pdf BgZ op basis van zibs release 2017] bestaat uit een selectie van 28 zibs. Deze zibs vormen samen een verzameling van patiëntgegevens die minimaal nodig is om patiënten continuïteit van zorg te kunnen bieden. De Basisgegevensset Zorg is gebaseerd op de Europese Patient Summary. 

Deze use case gebruikt de structuur die is aangebracht in BgZ 2017 van 18 secties waarin de onderdelen waaruit de BgZ is opgebouwd, gegroepeerd zijn. Deze secties komen sterk overeen met de secties van CCR/CCD en maken het o.a. mogelijk om in de technische implementatie (bv FHIR) structuur aan te brengen. In de MedMij FHIR implementatie gids staat de technische representatie van de betreffende zibs in zogenaamde FHIR profielen. In dit [[MedMij:V2019.01_FHIR_BGZ_2017#List_of_StructureDefinitions|overzicht]] is te zien welk FHIR profiel bij welke zib hoort.

=== 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 de eigen BgZ raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt de BgZ beschikbaar
|}
<font size = "1">'''Bedrijfsrollen Basisgegevensset Zorg'''</font>

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:InzienBGZ_activity.png|Activiteitendiagram Raadplegen BgZ]]

<font size = "1">'''Activiteitendiagram Raadplegen BgZ'''</font>

=== Procesbeschrijving ===
==== Patient journey - Thomas van Beek ==== 
De 'patient journey' van [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf Thomas van Beek] beschrijft enkele momenten waarop je als patiënt zijnde inzicht kan of zou willen hebben in zijn/haar BgZ. 

<blockquote>Voor zijn afstuderen verhuist Thomas 9 maanden naar Groningen. Hij gaat daar bij een heel leuk bedrijf stagelopen. Om het voor hem makkelijk te maken en omdat hij een arts dicht in de buurt wil hebben, schrijft hij zich in bij het ziekenhuis in Groningen. Hiervoor moet het ziekenhuis in Amsterdam alle gegevens van Thomas overdragen aan het ziekenhuis in Groningen. Zo weet de nieuwe arts van Thomas precies wat het verloop van de diabetes is. Thomas is zelf eigenlijk wel nieuwsgierig naar zijn medische gegevens die verstuurd worden. In zijn PGO vindt hij de belangrijkste gegevens die over hem bekend zijn.</blockquote>

==== Proces ====
Het stuk van het proces waar het in deze use case omgaat is:
* Het systeem van een zorgaanbieder (XIS) stelt de BgZ 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 BgZ tussen het betreffende XIS en het eigen PGO.

De BgZ, of een gedeelte van de BgZ, welke de persoon wil inzien, bestaat en de zorgaanbieder wil deze beschikbaarstellen.
:Soms zijn er valide redenen om de BgZ, of gedeeltes daarvan, 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 de BgZ 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 ===== 
* Het systeem van de patiënt (PGO) raadpleegt het systeem van de zorgaanbieder (XIS) voor de BgZ van de patiënt.
* Het systeem van de zorgaanbieder (XIS) maakt (een deel van) de BgZ beschikbaar voor de patiënt.
* De patiënt gebruikt de persoonlijke gezondheidsomgeving om de BgZ in te zien.

===== Post conditie ===== 
De persoon kan de Basisgegevensset Zorg inzien via een persoonlijke gezondheidsomgeving.

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


Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de BgZ van zorgaanbieder naar de persoon. 

{| 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;"| BGZRaadplegend 
| style="background-color: white;"| MM-2.1.3-BZR-FHIR
| style="background-color: white;"| Raadplegen BgZ bij zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| BGZBeschikbaarstellend 
| style="background-color: white;"| MM-2.1.3-BZB-FHIR
| style="background-color: white;"| Beschikbaarstellen BgZ aan de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:InzienBGZ_componenten.png|Componenten diagram]]

<font size = "1">'''Componenten diagram van systemen en systeemrollen'''</font>

=== 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:middle;" rowspan="2"|BgZ (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen BgZ
|style="background-color: white;vertical-align:top;"|MM-2.1.3-BZR-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:V2019.01_FHIR_BGZ_2017|BgZ in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen BgZ
|style="background-color: white;vertical-align:top;"|MM-2.1.3-BZB-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:InzienBGZ_useCase.png|Use case diagram inzien BgZ]]

<font size = "1">'''Use case diagram inzien BgZ</font>

=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;"| 
| style="background-color: white;"| 
| style="background-color: white;"| 
| style="background-color: white;"| 
| style="background-color: white;"| 
|}
<font size = "1">'''Referenties</font>

=Bijlage: Documenthistorie=
==Release notes==

In onderstaande tabel staan de wijzigingen voor deze informatiestandaard. Zie de [[MedMij:Vdraft_Ontwerpen#Release_Notes|Ontwerpen landingspagina]] voor wijzigingen die op alle informatiestandaarden van toepassing zijn.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Release
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS issue
!style="width:850px; text-align:left;"|Omschrijving
|-
| style="background-color: white; | 2019.01 - September
| style="background-color: white; | 2.1.4
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-425 MM-425]
| style="background-color: white;"| URL naar BGZ specificatie op FO en TO verwees naar versie 1.0, dit is aangepast naar de huidige en laatste versie 1.1.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-358 MM-358]
| style="background-color: white;"| Tekstcorrectie op de kwalificatie pagina ToelichtingKwalificatieGGZ.
|-
| rowspan = 28; style="background-color: white;"| 2019.01
| rowspan = 6; style="background-color: white;"| 2.1.3
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-348 MM-348]
| style="background-color: white;"| Foutieve discrimator path voor HCIM MedicationAgreement bij MedicationStatement.derivedFrom.
|- 
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-346 MM-346]
| style="background-color: white;"| Ongeldig discriminator pad in code slicing in ZIB Verrichting.
|- 
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-307 MM-307]
| style="background-color: white;"| Aanpassen mapping van "Reden wijzigen of staken" en "Reden wijzigen of stoppen gebruik" van HCIM naar MP9.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-294 MM-294]
| style="background-color: white;"| Naam mapping binnen div. FHIR profielen aangepast conform ZIB: HCIM LaboratoryTestResult-v4.1(2017EN).
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-258 MM-258]
| style="background-color: white;"| HCIM PharmaceuticalProduct: Added ValueSet 'IngredientCodeGTINCodeLijst' + correct reference url to ValueSet.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-248 MM-248]
| style="background-color: white;"| Fixed typo in sliceName 'medicationTreament' --> 'medicationTreatment'.
|-
| style="background-color: white;"| 2.1.2
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-219 MM-219]
| style="background-color: white;"| MedicationUse niet compleet na een resave in Forge.
|-
| rowspan = 2; style="background-color: white;"| 2.1.1
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-210 MM-210]
| style="background-color: white;"| MedMij BgZ is nog gebaseerd op 1.0 i.p.v. 1.1
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-206 MM-206]
| style="background-color: white;"| Reference vanuit Observation naar Specimen Isolate onjuist.
|-
| rowspan = 19; style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-174 MM-174]
| style="background-color: white;"| Corrected search url for PlannedCareActivityForTransfer - DeviceRequest. Added an '&'.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-161 MM-161]
| style="background-color: white;"| CBV codes in ProcedureRequest.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-145 MM-145]
| style="background-color: white;"| ContactPerson verwijzing informatiestandaarden vs patient zib.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-144 MM-144]
| style="background-color: white;"| Problem zib ClinicalStatus can take on values which are not defined by the HCIM.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-143 MM-143]
| style="background-color: white;"| Aanpassing modellering Procedure.performer in het profiel voor HCIM Verrichting.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-142 MM-142]
| style="background-color: white;"| Onduidelijkheid in de modellering van de Aanvrager van een LaboratoriumUitslag.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-141 MM-141]
| style="background-color: white;"| Vital Signs profielen inconsistent m.b.t. baseDefinition.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-134 MM-134]
| style="background-color: white;"| MedicationUse StopType found values do not correspond with MedicationUseStopTypeCodeList values.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-127 MM-127]
| style="background-color: white;"| TimeOfDay in InstructionsForUse and the Hapi Enumerators.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-125 MM-125]
| style="background-color: white;"| Inconsistentie wiki vs simplifier.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-118 MM-118]
| style="background-color: white;"| Profiel naam zib-Product niet passend bij Zib FarmaceutischProduct.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-115 MM-115]
| style="background-color: white;"| Solved inconsistency in the List of StructureDefinitions. Also we will no longer check PlannedCareActivityForTransfer for MedicationAdministration in section 17 Zorgplan, because we found it was unimplementable as-is. Presumed solution will come from a future HCIM release.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-100 MM-100]
| style="background-color: white;"| Mapping CBV naar SNOMED codes.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-99 MM-99]
| style="background-color: white;"| Interval heeft Period maar geen PeriodUnit op simplifier.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-98 MM-98]
| style="background-color: white;"| InstructionsForUse zib informatie model komt niet overeen met simplifier.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-94 MM-94]
| style="background-color: white;"| Specimen microorganism en specimenSource mappen naar hetzelfde fhir element.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-50 MM-50]
| style="background-color: white;"| Contact ondersteunt geen klinische contacten.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-42 MM-42]
| style="background-color: white;"| medicatiegebruik - auteur - zorgverlener: kan niet alle info kwijt.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-41 MM-41]
| style="background-color: white;"| voorschrijver/zorgverlener/zorgaanbieder past niet in medicationUse.
|-
| rowspan = 6; style="background-color: white;"| 2018.06
| rowspan = 6; style="background-color: white;"| 2.0.1
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-174 MM-174]
| style="background-color: white;"| URL voor PlannedCareActivity- DeviceRequest mist een '&'.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-128 MM-128]
| style="background-color: white;"| CanceledIndicator possible values.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-66 MM-66]
| style="background-color: white;"| Update mappings LaboratoriumUitslag in DiagnosticReport en Observation.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-55 MM-55]
| style="background-color: white;"| Profile for HCIM TobaccoUse was missing a specification for PackYears unit - profile updated to 2.0.1.
|-

| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-54 MM-54]
| style="background-color: white;"| Wrong SNOMED code in search URL for FunctionalOrMentalStatus.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-23 MM-23]
| style="background-color: white;"| Commentaar bij dagdeel codelijst verwijst naar dode URL.
|}

==Paginahistorie==
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Release
!style="text-align:left;"|Datum
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white; | 2019.01 - September
| style="background-color: white; | 30-09-2019
| style="background-color: white;"| 
* Wijzigingen voor september patch release.
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 27-06-2019
| style="background-color: white;"| 
* Toevoegen releasenotes voor patches. Ophogen versienummer naar 2.1.3.
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 24-04-2019
| style="background-color: white;"| 
* Toevoegen releasenote voor [https://bits.nictiz.nl/browse/MM-219 MM-219]
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 28-03-2019
| style="background-color: white;"| 
* Plaatsen release notes behorende bij patch 1.
* Versienummer systeemrolcodes ophogen met 1 patch nummer. 
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 11-03-2019
| style="background-color: white;"| 
* Wijzigingen gepubliceerd in versie 2019.01, zie release notes.
* Verplaatsing release notes naar functionele pagina.
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 18-10-2018
| style="background-color: white;"| 
* Toevoeging releasenotes en ophoging systeemrol versienummer vanwege een technische verbetering in de raadpleging van FunctioneleOfMentale gegevens.
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 15-10-2018
| style="background-color: white;"| 
* Aanpassing versienummer in titel en documenthistorie.
|-
| style="background-color: white;vertical-align:top;"| 2018.06
| style="background-color: white;vertical-align:top;"| 30-08-2018
| style="background-color: white;"| 
* Paragraaf 2.1.4, Verwijzing naar ART-DECOR toegevoegd.
* Bijlage: Documenthistorie toegevoegd.
* Paragraaf 1.4, verwijzing naar nieuwe pagina kwalificatie informatie toegevoegd.
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 16-08-2018
| style="background-color: white;"| 
* Structuur paragraaf 1.1 t/m 1.4 toegevoegd, ter voorbereiding kwalificatie informatie.
|}