Brontekst bekijken van MedMij:V2019.01 ToelichtingKwalificatieBgZ

{{MedMij:V2019.01_Issuebox}}

=Inleiding=
==Algemeen==
Hier vindt u informatie over de kwalificatie van de [https://www.registratieaandebron.nl/wat-is-registreren-aan-de-bron/de-kern-van-registreren-aan-de-bron/basisgegevensset/ Basisgegevensset Zorg], ofwel BgZ, binnen MedMij. 

Deze pagina beschrijft de eisen voor zowel de raadplegende als beschikbaarstellende systemen.

De kwalificatie is ingericht aan de hand van BgZ secties en de onderliggende zibs. BgZ omvat 18 secties, en 28 onderliggende zibs.

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

=Uitgangspunten=
==Uitgangspunten voor de kwalificatie systeemrol ‘Raadplegen BgZ’ (PGO)==
Hieronder volgen de uitgangspunten bij de kwalificatie van de systeemrol ‘Raadplegen BgZ’: 

* De BgZ is bewust als één geheel vastgesteld. Daarvoor kwalificeer je wel/niet binnen de MedMij context.  

* Een PGO raadpleegt altijd de gehele BgZ en daarmee dus alle secties (altijd alle FHIR searches). 

* Een PGO kan de gehele BgZ verwerken (gestructureerd opslaan in PGO database) en tonen. Dat geldt per zib voor alle onderliggende data-elementen (verplicht en optioneel).

* Een PGO biedt de persoon inzicht in de ontvangen respons. Als er geen gegevens beschikbaar gesteld worden, kan dat zijn omdat er geen informatie beschikbaar is in het XIS of vanwege een technische foutmelding. Er volgt bijvoorbeeld een foutmelding indien de resource, een BgZ sectie of specifieke zib, niet wordt ondersteund in het XIS. Het is een belangrijk inzicht voor de persoon dat gegevens technisch niet beschikbaar gesteld kan worden.  

* Bij raadpleging BgZ wordt gebruik gemaakt van losse queries en niet van bundeling als batch, onder andere om aan performance bezwaren tegemoet te komen.
* Mocht een PGO alleen enkele losse secties van de BgZ willen raadplegen, dan kan een PGO dat doen als daarvoor binnen MedMij een gegevensdienst en informatiestandaard beschikbaar is. Zoals voor labuitslagen bijvoorbeeld. Dit staat dan los van systeemrol ‘raadplegen BgZ’. 

* Bij BgZ raadpleging geldt soms een specifieke filtering voor een zib. Labuitslagen is binnen BgZ bijvoorbeeld beperkt tot de bekende klinische chemie bepalingen, en daarvan de laatste uitslag. Andere usecases voor labuitslagen kunnen vanuit de separate informatiestandaard labuitslagen ondersteund worden.

* De BgZ secties, en de volgorde daarvan, zoals ook aangehouden in de addenda van de kwalificatiescripts, bepalen niet ''hoe'' de gegevens moeten worden weergegeven en gesorteerd in een PGO. Voor kwalificatie moeten wel alle functionele data-elementen conform de dataset van de informatiestandaard getoond worden aan de gebruiker.

* In de addenda van de kwalificatiescripts kunnen voorbeelden met data-elementen uitgewerkt zijn, die via FHIR references resolved moeten worden. Bijvoorbeeld het specialisme van een zorgverlener bij een verrichting, dat via PractitionerRole opgehaald kan worden. In het geval dat een dergelijk voorbeeld is uitgewerkt, zal bij de kwalificatie ook gecontroleerd worden of de referentie correct 'resolved' is. Het uitgangspunt is dat alle references resolvable moeten zijn, niet ''dat'' ze resolved worden.  Een PGO zou er ook voor kunnen kiezen om een clickeable link te tonen, waarmee een gebruiker (de persoon) desgewenst zelf kan 'resolven', eventueel zelfs in een nieuwe sessie (na de initiële 15 minuten). Meer informatie over het gebruik van FHIR references binnen MedMij is te vinden in de informatiestandaard overstijgende principes op de [https://informatiestandaarden.nictiz.nl/wiki/MedMij:Vdraft_FHIR_IG#Use_of_the_reference_datatype technische ontwerp pagina].

==Uitgangspunten voor de kwalificatie systeemrol ‘Beschikbaarstellen BgZ’ (XIS)==
Hieronder volgen de uitgangspunten voor de kwalificatie van de systeemrol ‘Beschikbaarstellen BgZ’: 

* XIS geeft technisch correct antwoord op alle searches ongeacht of de gegevens in XIS beschikbaar zijn. XIS stelt alle BgZ gegevens beschikbaar voor zover aanwezig.  

* Mochten gegevens niet beschikbaar gesteld kunnen worden, dan is uit de respons voor de persoon te herleiden waardoor dit veroorzaakt wordt:
**veroorzaakt door het ontbreken van de informatie
**veroorzaakt doordat het XIS dit technisch niet kan leveren.  

* In het geval dat een vraag om gegevens goed wordt verwerkt door het XIS, volgt een respons met daarin 0 tot * FHIR resources die matchen aan de vraag. Als er dus 0 resources in zitten mag de persoon ervan uitgaan dat het XIS deze gegevens niet heeft, maar de vraag wel goed begrepen heeft. 

* Als er technisch iets niet goed gaat, stuurt het XIS conform de specificaties een foutcode terug samen met een OperationOutcome, waarin de oorzaak wordt getoond. Bijvoorbeeld dat de resource, een BgZ sectie of specifieke zib, niet wordt ondersteund in het XIS. Waarschijnlijk moeten de specificaties hiervoor worden aangevuld met een OperationOutcome specifiek voor deze situatie. Deze moet ingebouwd worden door het XIS. Hierop wordt het XIS ook gekwalificeerd. 

* Mocht XIS alleen enkele losse secties van de BgZ beschikbaar willen / kunnen stellen, dan kan XIS dat doen als daarvoor binnen MedMij een gegevensdienst en informatiestandaard beschikbaar is. Zoals voor labuitslagen bijvoorbeeld. Dan kwalificeert een XIS voor die informatiestandaard, maar niet voor BgZ. Dit komt overzichtelijkheid ten goede voor persoon en PGO. 

* Voorafgaand aan kwalificatie wordt vastgesteld welke BgZ-gegevens het XIS ondersteunt. 
* BgZ gegevens die in XIS vastgelegd worden, dienen ook ontsloten te worden. 

* Idealiter ondersteunt een BgZ beschikbaarstellend systeem de gehele BgZ, maar om een XIS tegemoet te komen, kwalificeert een XIS bij ondersteuning van minimaal 14 van de 18 BgZ secties of 20 van de 28 onderliggende Zibs. Dit wijkt bewust af van het uitgangspunt voor PGO, omdat in het zorgproces dat het XIS ondersteunt, doorgaans niet de gehele BgZ vastgelegd hoeft te worden. In tegenstelling tot PGO waarin de persoon een zo compleet mogelijk overzicht van zorggegevens wil hebben. 
** Op technisch niveau moet per zib alle onderliggende data-elementen (verplicht en optioneel) ingebouwd zijn. De vulling van deze data-elementen is afhankelijk van de klinische relevantie bepaald door de use case.

* XIS leverancier ondersteunt ‘Beschikbaarstellen BgZ’ vanaf een bepaalde softwareversie. Deze versie kan binnen het VIPP-programma (module A3) gebruikt worden voor de bepaling van de financiering per ziekenhuis.

==Samenvatting==
De gehele BgZ wordt als usecase gehanteerd, en de kwalificatie is daarop ingericht. 

Binnen MedMij kan worden gekwalificeerd voor de systeemrollen ‘raadplegen BgZ’ en ‘beschikbaarstellen BgZ’.

De gehele BgZ wordt geraadpleegd via losse queries. Er wordt geen gebruik gemaakt van FHIR bundle bij raadplegen en beschikbaarstellen. 

PGO kwalificeert als de gehele BgZ geraadpleegd, verwerkt en getoond kan worden.
 
XIS kwalificeert bij beschikbaarstellen van minimaal 14 van de 18 BgZ secties. Of 20 van de 28 onderliggende zibs.

=Bijlage: Documenthistorie=

==Paginahistorie==
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Datum
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| 15-04-2019
| style="background-color: white;"| 
* Nadere toelichting ten aanzien van FHIR references toegevoegd. Gerelateerd aan BITS-issue [https://bits.nictiz.nl/browse/MM-220 MM-220]
* Nadere toelichting ten aanzien van sortering BgZ secties toegevoegd. Gerelateerd aan BITS-issue [https://bits.nictiz.nl/browse/MM-193 MM-193]
|-
| style="background-color: white;"| 02-11-2018
| style="background-color: white;"| 
* Nadere toelichting zib data-elementen toegevoegd.
* Paginahistorie toegevoegd.
|-