MedMij:Vprepub-2019.01 Ontwerpen
{{#customtitle:Ontwerpen MedMij|Functioneel Ontwerpen}}
1 Inleiding
1.1 Algemeen
Hier vindt u informatie over de inhoud van de informatie die kan worden uitgewisseld in het MedMij afsprakenstelstel.
Deze pagina beschrijft allereerst de algemeen geldende en overkoepelende informatie van de functionele ontwerpen voor MedMij en bevat vervolgens verwijzingen naar specifieke functionele ontwerpen en technische specificaties voor die use cases die onderdeel zijn van het afsprakenstelsel.
1.2 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.
1.3 Kaders en uitgangspunten
1.3.1 Richtlijn
Het programma '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 '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 zibs.
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.
De dataset van MedMij informatiestandaarden is zoveel als mogelijk samengesteld gebruikmakend van bestaande zibs, waarmee de functionele definitie voor het uitwisselen van zorggegevens in MedMij gevormd wordt. Dit is bij het ondersteunen van de MedMij informatiestandaarden in applicaties ook richtinggevend voor te gebruiken Nederlandse termen. Voor het verwerken en tonen van beschikbaar gestelde waarden van terminologie- en codestelsels (zoals SNOMED CT) in een PGO, hanteren we een nader uitgewerkt uitgangspunt:
- Indien er een Nederlandse patiëntvertaling beschikbaar is, dient die getoond te worden aan de PGO gebruiker.
- Indien een Nederlandse patiëntvertaling ontbreekt, maar er wel een Nederlandse zorgverlener vertaling beschikbaar is, dient deze getoond te worden.
- Indien Nederlandse patiëntvertaling en zorgverlener vertaling beide ontbreken in het terminologie- of codestelsel, dient de dataset gevolgd te worden, waarin voor uitgewerkte waardelijsten ook Nederlandse termen beschikbaar zijn.
- Indien Nederlandse vertaling geheel ontbreekt, kan de Engelse term getoond worden.
1.3.2 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 afsprakenstelsel met spelregels die zorgen dat de gegevensuitwisseling veilig is, privacy geborgd is en dat systemen aan juridische eisen voldoen.
1.3.3 Geografische reikwijdte
De geografische scope van alle ontwerpen van MedMij is Nederland.
1.4 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 in ToelichtingSubsidie.
Voor meer informatie, stuur een mail naar 'kwalificatie@medmij.nl'.
Kwalificatiescripts en meer informatie over de kwalificatie is te vinden via de betreffende paragraaf op de Kwalificatiepagina.
2 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.
3 Ontwerpen
Patient journeys beschrijven de mogelijkheden die MedMij biedt vanuit het perspectief van een fictieve patiënt. Deze paragraaf start met de Patient journeys die MedMij hanteert.
De paragraaf vervolgt met een index in tabelvorm gesplitst naar de use cases van het afsprakenstelsel:
3.1 Patient journeys
3.1.1 Thomas van Beek
De beschrijving van de casus van de fictieve patiënt Thomas van Beek vindt u 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.
3.1.2 Roos Dalstra
De beschrijving van de casus van de fictieve patiënt Roos Dalstra vindt u 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.
3.2 Haal gegevens op uit XIS
3.2.1 Algemeen
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.
Index raadplegen / beschikbaarstellen | |||||
Informatiestandaard | Versie | Use case | Functioneel | Technisch | |
Basisgegevensset Zorg | Basisgegevensset Zorg, op basis van ZIB's release 2017 | BgZ | BgZ in FHIR | ||
Labuitwisseling | Laboratoriumresultaten | Laboratoriumresultaten | Laboratoriumresultaten in FHIR | ||
Medicatieproces | Medicatieoverzicht | Medicatieoverzicht | Medicatieoverzicht in FHIR | ||
Medicatiegegevens | Medicatiegegevens | Medicatiegegevens in FHIR | |||
Verstrekkingenvertaling | Verstrekkingenvertaling | Verstrekkingenvertaling in FHIR | |||
AllergieIntolerantie | Allergie/intolerantie | AllergieIntolerantie | AllergieIntolerantie in FHIR | ||
eAfspraak | Afspraken raadplegen | eAfspraak | eAfspraak in FHIR | ||
Zelfmetingen | Zelfmetingen raadplegen | Zelfmetingen | Zelfmetingen in FHIR | ||
PDF/A | PDF/A raadplegen | PDF/A | PDF/A in FHIR | ||
Huisartsgegevens | Huisartsgegevens | Huisartsgegevens | GP data in FHIR | ||
Basisgegevens GGZ | Basisgegevens GGZ | Basisgegevens GGZ | GGZ data in FHIR |
3.2.2 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 "overarching principles" van het technisch ontwerp.
3.3 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.
Index sturen / ontvangen | |||||
Informatiestandaard | Versie | Use case | Functioneel | Technisch | |
Zelfmetingen | Zelfmetingen sturen | Zelfmetingen | Zelfmetingen in FHIR | ||
eAfspraak | Afspraak maken | eAfspraak maken | eAfspraak maken in FHIR | ||
Afspraak annuleren | eAfspraak annuleren | eAfspraak annuleren in FHIR | |||
Afspraak wijzigen | eAfspraak wijzigen | eAfspraak wijzigen in FHIR | |||
PDF/A | PDF/A | PDF/A | |||
Beelden | Beelden sturen | Beelden | Beelden in FHIR |
4 Systeemrollen
De informatiestandaard kent altijd een formele beschrijving met ten minste de volgende metagegevens: De informatiestandaard (met een informatiestandaardnaam) bestaat uit een of meer transacties (met per transactie een transactienaam), met voor elk van de transacties een aanduiding van de bijbehorende systeemrollen en de bijbehorende bedrijfsrol (Patiëntbedrijfsrol of Zorgaanbiedersbedrijfsrol). Op basis van de systeemrol wordt door de MedMij autorisatieraad, het bestuur van Stichting MedMij, een systeemrolcode toegekend. Deze identificeert 1 versie van 1 systeemrol. Een versie van een systeemrol wordt geïdentificeerd door 1 Systeemrol-code. Deze metagegevens zijn van belang voor de definitie van de gegevensdiensten binnen het MedMij afsprakenstelsel. Nadere informatie over gegevensdiensten, zoals de geldigheidsperiode, vindt u in de Catalogus van het MedMij Afsprakenstelsel: https://afsprakenstelsel.medmij.nl/display/PUBLIC/Catalogus
In het register van informatiestandaarden zijn alle systeemrollen opgenomen die van toepassing zijn in de MedMij use cases.
5 Release Notes
Versie | BITS issue | Omschrijving |
---|---|---|
2019.01 patch 2 | MM-219 | MedicationUse niet compleet na een resave in Forge. |
MM-220 | Nadere toelichting ten aanzien van FHIR references. | |
MM-222 | Update verouderde tekst van richtlijn paragraaf op FO Ontwerp pagina. | |
2019.01 patch 1 | MM-200 | Verloren wijzigingen d.m.v. foutieve commit goed zetten. |
MM-198 | PractitionerRole extensie ontbreekt bij Patient.generalPractitioner. | |
MM-189 | Concept PractitionerRole wijkt af van FHIR core. | |
2019.01 | MM-180 | Toelichting functionele definitie via zibs, inclusief Nederlandse termen zorggegevens |
MM-149 | Patient.gender mist ConceptMap voor GeslachtCodelijst. | |
MM-139 MM-133 |
PractitionerRole reference extensie toegevoegd aan elementen die naar Practitioner verwijzen. | |
MM-122 | ConceptMaps benoemen + aanmaken | |
MM-89 | Consistentie referenties naar (zib) profielen of base resources voor niet-zib concepten. | |
MM-88 | Mapping BasisElementen ontbreekt. | |
MM-72 | Added concept name to all profile mappings from HCIMs or datasets. | |
MM-70 | Updated links in technical design pages for profiles so they have less maintenance. | |
MM-65 | Generic guidance on references added. | |
2018.06 | MM-136 | Payer.PayerPerson.PayerName is a String but simplifier says it is a nl-core-humanname. |
MM-83 | Tegenstellende definities van land tussen de Nictiz Zib wiki en de FHIR standaarden. | |
MM-81 | Gebruik van AddressType in AddresInformation ZIB. | |
MM-77 | Ambiguïteit bij HouseNumberAddition/HouseNumberLetter. | |
MM-76 | Wat hoort er thuis in het FirstNames veld in de NameInformation Zib? | |
MM-47 | Suggestion: require display or text on codes. |
6 Releases
Versie | Datum | Omschrijving |
---|---|---|
2019.01 | 2019-03-11 | Alle MedMij-standaarden |
2018.06 | 2018-10-29 | Basisgegevens GGZ |
2018.05 | 2018-09-24 | Basisgegevens GGZ voor openbare consultatie |
2018.04 | 2018-09-02 | eAfspraak fase 2 |
2018.03 | 2018-05-07 | BgZ 2017 en Huisartsgegevens |
2018.02 | 2018-03-29 | BgZ 2017 voor openbare consultatie |
2018.01 | 2018-02-21 | Huisartsgegevens voor openbare consultatie |
2017.04 | 2017-12-18 | Medicatie, Laboratoriumresultaten, Allergie/intolerantie, Zelfmetingen |
2017.03 | 2017-11-07 | PDF/A |
2017.02 | 2017-10-11 | eAfspraak |
2017.01 | 2017-10-02 | BgZ 2015 |