Brontekst bekijken van MedMij:V2020.02/Ontwerpen

__NUMBEREDHEADINGS__
{{DISPLAYTITLE: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:V2020.02/Ontwerpen|Functioneel]]                
circle 1787 230 212 [[MedMij:V2020.02/FHIR_IG|Technisch]]                
desc none                    
</imagemap>

=Inleiding=
==Algemeen==
{{#lsth:MedMij:V2020.01/Ontwerpen|Algemeen}}
==Publicaties en versies==
{{#lsth:MedMij:Vprepub-2020.01/Ontwerpen|Publicaties en versies}}
==Doelgroep==
{{#lsth:MedMij:V2020.01/Ontwerpen|Doelgroep}}
==Kaders en uitgangspunten==
===Richtlijn===
====Zorginformatiebouwstenen en gegevenssets====
{{#lsth:MedMij:V2020.01/Ontwerpen|Zorginformatiebouwstenen en gegevenssets}}
====Terminologie en vertalingen====
Richtinggevend voor de applicaties die MedMij-standaarden implementeren is dat ze Nederlandse termen gebruiken. Dit wordt op de volgende wijze functioneel en technisch ondersteund. 

'''Functioneel'''

De functionele definities van de MedMij-informatiestandaarden zijn zoveel mogelijk samengesteld uit bestaande zibs. De zibs bevatten veel (eigen) waardelijsten. Bij deze waardelijsten wordt een Nederlandse vertaling gegeven. 

Voor het verwerken en tonen van waarden uit bestaande terminologie- en codestelsels (zoals SNOMED CT en LOINC) in een PGO, kan het volgende uitgangspunt gehanteerd worden: 

*Indien er een Nederlandse patiëntvertaling beschikbaar is, toon deze aan de PGO-gebruiker.
*Indien een Nederlandse patiëntvertaling ontbreekt, maar er wel een Nederlandse zorgverlenervertaling beschikbaar is, toon deze aan de PGO-gebruiker.
*Indien zowel een Nederlandse patiëntvertaling als een zorgverlenervertaling ontbreken in het terminologie- of codestelsel, volg de dataset, waarin voor uitgewerkte waardelijsten ook Nederlandse termen beschikbaar zijn.
*Indien Nederlandse vertaling geheel ontbreekt, kan de Engelse term getoond worden.

Meer informatie over eventueel benodigde licentie en implementatie van terminologie- en codestelsels is te vinden in het [https://www.nictiz.nl/overzicht-standaarden/ standaarden overzicht van Nictiz]

Ook wat betreft de omschrijving van informatie geniet het de voorkeur om ze veel mogelijk gebruik te maken van Nederlandse termen. De (omschrijvingen van de) conceptnamen die in zibs gehanteerd worden, kunnen gebruikt worden, evenals correcte Nederlandse synoniemen daarvan die mogelijk beter aansluiten op het persoonsdomein.

'''Technisch'''

Voor de waardelijsten in de zibs zijn FHIR ValueSet-resources gemaakt. Deze bevatten gestructureerd de Nederlandse vertalingen van de zib-concepten en worden dus bij de standaard aangeboden. Leveranciers kunnen bij het weergeven van concepten uit deze ValueSets dan ook kiezen voor de Nederlandse vertaling. 

De ValueSets zijn óf direct gekoppeld in de FHIR-profielen, of kunnen, indien dit niet mogelijk is, via een FHIR ConceptMap gerelateerd worden aan de waarden die binnen een profiel gebruikt worden. Zie hiervoor de specificaties in de [[MedMij:V2020.02/FHIR_IG#Use_of_coded_concepts|FHIR-implementatiegids]].
====Referenties====
MedMij informatiestandaarden gebruiken zoveel mogelijk bestaande zibs. Deze zibs verwijzen naar elkaar middels referenties. FHIR kent ook het concept van referenties. Via zo'n referentie kan bijvoorbeeld ook het specialisme van een zorgverlener bij een verrichting opgehaald worden. Het uitgangspunt is dat alle references 'resolvable' (opvraagbaar) moeten zijn, niet dat ze resolved worden. Een PGO zou er ook voor kunnen kiezen om een klikbare 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 informatiestandaardoverstijgende principes in de [[MedMij:V2020.02/FHIR_IG#Use_of_the_reference_datatype |FHIR-implementatiegids]].

====Herleidbaarheid====
{{#lsth:MedMij:Vprepub-2020.01/Ontwerpen|Herleidbaarheid}}
===Infrastructuur===
{{#lsth:MedMij:V2020.01/Ontwerpen|Infrastructuur}}
===Geografische reikwijdte===
{{#lsth:MedMij:V2020.01/Ontwerpen|Geografische reikwijdte}}
==Kwalificatie==
===Introductie===
<section begin=medmij_kwalificatie_introductie />
Op deze informatiestandaard is een Nictiz kwalificatie van toepassing. Kwalificatie vindt plaats per systeemrol.

Kwalificatiescripts en meer informatie over de kwalificatie is te vinden via de betreffende paragraaf op de [[MedMij:V2020.02/Kwalificatie|kwalificatiepagina]].<section end=medmij_kwalificatie_introductie /><section end=medmij_kwalificatie_introductie />

=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.

<imagemap>Bestand:MedMij_wiki_structuur_overzicht.png||650px|alt=MedMij Wiki structuur overzicht   
circle 344 894 333 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]   
rect 1017 1260 1517 1407 [[Landingspagina_MedMij#Mappings|Mappings]]             
rect 2123 3 2740 847 [[MedMij:V2020.02/Ontwerpen|Functioneel]]                
rect 2123 945 2740 1789 [[MedMij:V2020.02/FHIR_IG|Technisch]]                
desc none                    
</imagemap>

=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]] 

==Haal gegevens op uit XIS==
===Algemeen===
Een persoonlijke gezondheidsomgeving (PGO) haalt gegevens op bij een zorginformatiesystemen (XIS). Onderstaande tabel geeft een overzicht van de use cases uit informatiestandaarden in publicatie 2020.02 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 / beschikbaarstellen
|-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:BgLZ-icon.png|link=MedMij:V2020.01/OntwerpLangdurigeZorg|49px|Basisgegevens Langdurige Zorg]]||Basisgegevens Langdurige Zorg||||Basisgegevens Langdurige Zorg raadplegen|| [[MedMij:V2020.02/OntwerpLangdurigeZorg|BgLZ ]] ||[[MedMij:V2020.02/FHIR_BGLZ|BgLZ in FHIR]]
|-style="background-color: white;"
|}
Onderstaande tabel geeft een overzicht van de use cases uit de overige informatiestandaarden die van toepassing zijn voor het raadplegen van informatie.
{{NoteBox|1= De informatiestandaarden in onderstaande tabel maken geen deel uit van publicatie 2020.02. De links verwijzen naar de meest recente publicatie.}}
{| class="wikitable" 
| style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:center; border: 1px solid black;"   colspan="6" | Index raadplegen / beschikbaarstellen
|-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]||[[MedMij:V2020.01/OntwerpBGZ_2017#Use_case_1:_Raadplegen_Basisgegevensset_Zorg_in_persoonlijke_gezondheidsomgeving|BgZ]]||[[MedMij:V2020.01/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:V2020.01/OntwerpLabresult#Use_case:_Raadplegen_laboratoriumresultaten_in_persoonlijke_gezondheidsomgeving|Laboratoriumresultaten]]||[[MedMij:V2020.01/FHIR_LaboratoryResults|Laboratoriumresultaten in FHIR]]
|-style="background-color: white;" 
|rowspan="3"|[[Bestand:Medicatie.png|link=https://www.nictiz.nl/Paginas/Informatiestandaard-Medicatieproces.aspx|49px]]
|rowspan="3"|[https://www.nictiz.nl/Paginas/Informatiestandaard-Medicatieproces.aspx Medicatieproces]
|rowspan="3"|
||Medicatieoverzicht 
||[[MedMij:V2020.01/OntwerpMedicatie#Use_case:_Raadplegen_medicatieoverzicht_in_persoonlijke_gezondheidsomgeving|Medicatieoverzicht]]
||[[MedMij:V2020.01/FHIR_MedicationProcess#Use_case:_retrieve_medication_overview |Medicatieoverzicht in FHIR]]
|-style="background-color: white;"
||Medicatiegegevens ||[[MedMij:V2020.01/OntwerpMedicatie#Use_case:_Raadplegen_medicatiegegevens_door_pati.C3.ABnt|Medicatiegegevens]]
||[[MedMij:V2020.01/FHIR_MedicationProcess#Use_case:_retrieve_medication_information |Medicatiegegevens in FHIR]]
|-style="background-color: white;"
||Verstrekkingenvertaling||[[MedMij:V2020.01/OntwerpMedicatie#Use_case:_Raadplegen_verstrekkingenvertaling_.28medicatieverstrekkingen_van_het_LSP.29_door_pati.C3.ABnt|Verstrekkingenvertaling]]
||[[MedMij:V2020.01/FHIR_MedicationProcess#Use_case:_retrieve_medication_information|Verstrekkingenvertaling in FHIR]]
|-
|rowspan="2"|[[Bestand:Allergie.png|link=MedMij:V2020.01/OntwerpAllergieIntolerantie| AllergieIntolerantie|49px]]
|rowspan="2"|[[MedMij:V2020.01/OntwerpAllergieIntolerantie | AllergieIntolerantie]]
|rowspan="2"|
||Allergie/intolerantie ||[[MedMij:V2020.01/OntwerpAllergieIntolerantie| AllergieIntolerantie]] ||[[MedMij:V2020.01/FHIR_AllergyIntolerance#Use_case:_Retrieve_AllergyIntolerance_information|AllergieIntolerantie in FHIR]]
|-
||Allergie/intolerantie vertaling ||[[MedMij:V2020.01/OntwerpAllergieIntolerantie#Use_case_2:_Raadplegen_medicatiegerelateerde_allergie-_en_intolerantiegegevensvertaling_door_pati.C3.ABnt| AllergieIntolerantieVertaling]] ||[[MedMij:V2020.01/FHIR_AllergyIntolerance#Use_case:_Retrieve_AllergyIntolerance612ToFHIRConversion|AllergieIntolerantieVertaling in FHIR]]
|-style="background-color: white;"
|[[Bestand:EAfspraak_icoon_zonder_tekst.png|link=MedMij:V2020.01/OntwerpeAfspraak|49px]]
||eAfspraak
||||Afspraken raadplegen
||[[MedMij:V2020.01/OntwerpeAfspraak#Use_case:_Afspraak_raadplegen_door_pati.C3.ABnt| eAfspraak]]
|| [[MedMij:V2020.01/FHIR_eAfspraak| eAfspraak in FHIR]]
|-
|[[Bestand:Self-Measuements_zonder_tekst.png|link=MedMij:V2020.01/OntwerpZelfmetingen|49px]]
||Zelfmetingen
||||Zelfmetingen raadplegen||[[MedMij:V2020.01/OntwerpZelfmetingen|Zelfmetingen]]||[[MedMij:V2020.01/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:V2020.01/OntwerpPDFA| PDF/A]] ||[[MedMij:V2020.01/FHIR_PDFA|PDF/A in FHIR]]
|-
|[[Bestand:Huisartsgegevens-zonder-tekst-dun.png|link=MedMij:V2020.01/OntwerpHuisartsgegevens|49px|Huisartsgegevens]]||Huisartsgegevens|||| Huisartsgegevens || [[MedMij:V2020.01/OntwerpHuisartsgegevens|Huisartsgegevens]] ||[[MedMij:V2020.01/FHIR_GP_Data|GP data in FHIR]]
|-style="background-color: white;"
|[[Bestand:GGZ-59.-zondertekst.png|49px|GGZ]]
||Basisgegevens GGZ|||| Basisgegevens GGZ|| [[MedMij:V2020.01/OntwerpGGZ|Basisgegevens GGZ]] ||[[MedMij:V2020.01/FHIR_GGZ|GGZ data in FHIR]]
|-
|[[Bestand:vragenlijstenIcoon.png|link=MedMij:V2020.01/OntwerpVragenlijsten|49px|Vragenlijsten]]
||Vragenlijsten||||Vragenlijsten||[[MedMij:V2020.01/OntwerpVragenlijsten|Vragenlijsten]] ||[[MedMij:V2020.01/FHIR_Questionnaire_and_Questionnaire_Response_(Vragenlijsten)|Vragenlijsten in FHIR]]
|}

===What's new===
Een PGO kan na een eerste raadpleging nieuwe of gewijzigde gegevens raadplegen middels een "what's new" uitvraag. Voordeel van deze functionaliteit is dat niet onnodig reeds bekende gegevens opnieuw beschikbaar gesteld hoeven te worden. Denk hierbij aan wederom raadplegen van een volledige gegevensset zoals de BgZ. PGO dient hiervoor de datum van eerdere raadpleging te bewaren, om te gebruiken in een nieuwe raadpleging. XIS dient deze datum te kunnen verwerken. Technische uitwerking staat in de [https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2020.01/FHIR_IG#Use_case_overarching_principles "overarching principles" van het technisch ontwerp].

==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.
{{NoteBox|1= De informatiestandaarden in onderstaande tabel maken geen deel uit van publicatie 2020.02. De links verwijzen naar de meest recente publicatie.}}
{| 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:Medicatie.png|link=https://www.nictiz.nl/Paginas/Informatiestandaard-Medicatieproces.aspx|Medicatieproces|50px]]||[https://www.nictiz.nl/Paginas/Informatiestandaard-Medicatieproces.aspx Medicatieproces]||||Medicatiegebruik |||| -->
|-style="background-color: white;"
|[[Bestand:Self-Measuements_zonder_tekst.png|link=|50px|Zelfmetingen]]||Zelfmetingen||||Zelfmetingen sturen||[[MedMij:V2020.01/OntwerpZelfmetingen#Use_case:_Sturen_zelfmetingen_van_de_vitale_functies_door_pati.C3.ABnt|Zelfmetingen]]||[[MedMij:V2020.01/FHIR_VitalSigns|Zelfmetingen in FHIR]]
|-
|-style="background-color: white;"
|[[Bestand:PDF-A_icoon_zonder_tekst.png|link=|50px|PDF/A]]||PDF/A||||PDF/A|||[[MedMij:V2020.01/OntwerpPDFA#Use_case:_Sturen_medische_gegevens_in_PDF.2FA_door_pati.C3.ABnt| PDF/A]]||[[MedMij:V2020.01/FHIR_PDFA|PDF/A in FHIR]]
|-
|[[Bestand:Beelden.png|link=|50px|Beelden]]||Beelden||||Beelden sturen|||[[MedMij:V2020.01/OntwerpBeelden|Beelden]] || [[MedMij:V2020.01/FHIR_Images|Beelden in FHIR]]
|-style="background-color: white;"
|[[Bestand:vragenlijstenIcoon.png|link=MedMij:V2020.01/OntwerpVragenlijsten|50px|Vragenlijsten]]
||Vragenlijsten||||Vragenlijsten|| [[MedMij:V2020.01/OntwerpVragenlijsten|Vragenlijsten]] ||[[MedMij:V2020.01/FHIR_Questionnaire_and_Questionnaire_Response_(Vragenlijsten)|Vragenlijsten in FHIR]]
|}

==Patient journeys==
{{#lsth:MedMij:V2020.01/Ontwerpen|Patient journeys}}
=Systeemrollen=
{{#lsth:MedMij:V2020.01/Ontwerpen|Systeemrollen}}
=Release notes=
{{#lsth:Tabellen met release notes|MedMij 2020.02}}

=Releases=
{| class="wikitable" 
! Versie !! Datum !! Omschrijving
|-
| [[MedMij:V2020.01/Ontwerpen|2020.01]] || 2020-08-11 || Zomerrelease met wijzigingen voor MedMij-standaarden
|-
| [[MedMij:V2019.01_Ontwerpen|2019.01]] || 2019-10-18 || Use case medicatiegerelateerde allergie- en intolerantiegegevensvertaling toegevoegd
|-
| [[MedMij:V2019.01_Ontwerpen|2019.01]] || 2019-10-02 || Use case PDF/A Sturen toegevoegd
|-
| [[MedMij:V2019.01_Ontwerpen|2019.01]] || 2019-03-11 || Alle MedMij-standaarden
|-
| [[MedMij:V2018.06_Ontwerpen|2018.06]] || 2018-10-29 || Basisgegevens GGZ
|-
| [[MedMij:V2018.05_Ontwerpen|2018.05]] || 2018-09-24 || Basisgegevens GGZ voor openbare consultatie
|-
| [[MedMij:V2018.04_Ontwerpen|2018.04]] || 2018-09-02 || 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 
|}