Brontekst bekijken van MedMij:V2020.01/OntwerpLabresult

__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Laboratoriumresultaten {{VersieInfo|Laboratoriumresultaten}}}}
{{MedMij:V2020.01/Issuebox}}

[[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:V2020.01/Ontwerpen|Functioneel]]                
circle 1787 230 212 [[MedMij:V2020.01/FHIR_LaboratoryResults|Technisch]]                
desc none                    
</imagemap>

=Inleiding=
==Algemeen==
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:V2020.01/Ontwerpen|op deze pagina]] aangegeven, gebruikt MedMij de BGZ en de bijbehorende zibs als leidraad voor de uitwisseling van informatie. Voor uitwisseling van laboratoriumresultaten gaat het om de volgende zibs:
*Patiënt; 
*Zorgaanbieder; 
*Zorgverlener; 
*LaboratoriumUitslag.

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

==Kaders en uitgangspunten==
===Richtlijn===
Conform specificaties genoemd in [[MedMij:V2020.01/Ontwerpen#Richtlijn| de algemene inleiding]] van de MedMij functionele ontwerpen.

Toelichting op de zorginformatiebouwstenen: Laboratoriumresultaten versie {{VersieInfo|Laboratoriumresultaten}} maakt gebruik van [https://zibs.nl/wiki/ZIB_Publicatie_2017(NL) zib publicatie 2017].

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

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

==Kwalificatie==
===Introductie===
{{#lst:MedMij:V2020.01/Ontwerpen|medmij_kwalificatie_introductie}}

=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
*LaboratoriumUitslag v4.1

Informatie elementen in LaboratoriumUitslag staan [https://zibs.nl/wiki/LaboratoriumUitslag-v4.1(2017NL) 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
|}
<font size = "1">'''Bedrijfsrollen Laboratoriumresultaten'''</font>

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

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

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

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas van Beek vindt u [[Media: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 als patiënt maken 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 laboratoriumresultaten van zorgaanbieder naar de patiënt.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| LaboratoriumresultaatRaadplegend 
| style="background-color: white;"| LAB-{{VersieInfo|Laboratoriumresultaten}}-LRR-FHIR
| style="background-color: white;"| Raadplegen Laboratoriumresultaat bij zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| LaboratoriumresultaatBeschikbaarstellend 
| style="background-color: white;"| LAB-{{VersieInfo|Laboratoriumresultaten}}-LRB-FHIR
| style="background-color: white;"| Beschikbaarstellen Laboratoriumresultaat aan de patiënt
|-
|}

Zie ook onderstaande afbeelding.

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

<font size = "1">'''Componenten diagram'''</font>

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;"| '''Systeemrolcode'''
! 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-{{VersieInfo|Laboratoriumresultaten}}-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:V2020.01/FHIR_LaboratoryResults|Laboratoriumresultaten in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen laboratoriumresultaten
|style="background-color: white;vertical-align:top;"|LAB-{{VersieInfo|Laboratoriumresultaten}}-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]]

<font size = "1">'''Use case diagram</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;"| 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
|}
<font size = "1">'''Referenties</font>

=Release notes=

In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.
{{#lsth:Tabellen met release notes|Laboratoriumresultaten 2}}

{{MedMij:Sjabloon_Ondersteuning}}