Zandbak/test-diagrams: verschil tussen versies

Uit informatiestandaarden
Naar navigatie springen Naar zoeken springen
k (Tekst vervangen - "{{#customtitle:" door "{{DISPLAYTITLE:")
 
(4 tussenliggende versies door een andere gebruiker niet weergegeven)
Regel 1: Regel 1:
 
__NUMBEREDHEADINGS__
 
__NUMBEREDHEADINGS__
{{#customtitle:Functioneel Ontwerp PDF/A 2.0.0}}
+
{{DISPLAYTITLE:Functioneel Ontwerp PDF/A 2.0.0}}
 
{{MedMij:V2019.01_Issuebox}}  
 
{{MedMij:V2019.01_Issuebox}}  
  
Regel 212: Regel 212:
 
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.
 
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.
  
[[Bestand:Use Case Diagram - PDFA raadplegen.png|Use case diagram PDF/A raadplegen]]
+
[[Bestand:Raadplegen_BGZ_use_case.png|Use case diagram BGZ raadplegen]]
  
<font size = "1">'''Use case diagram PDF/A Raadplegen</font>
+
<font size = "1">'''Use case diagram BGZ Raadplegen</font>
  
 
==Use case: Sturen gezondheidsinformatie in PDF/A door patiënt==
 
==Use case: Sturen gezondheidsinformatie in PDF/A door patiënt==
Regel 339: Regel 339:
 
Zie ook onderstaande afbeelding.
 
Zie ook onderstaande afbeelding.
  
[[Bestand:Component Diagram - PDFA sturen (Totaal)2.png |Componenten diagram PDFA sturen]]
+
[[Bestand:component_1.png |component_1]]
 +
 
 +
<font size = "1">'''Componenten diagram PDF/A Sturen'''</font>
 +
 
 +
Zie ook onderstaande afbeelding.
 +
 
 +
[[Bestand:component_2.png |component_2]]
  
 
<font size = "1">'''Componenten diagram PDF/A Sturen'''</font>
 
<font size = "1">'''Componenten diagram PDF/A Sturen'''</font>
Regel 371: Regel 377:
 
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.
 
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.
  
[[Bestand:Use Case Diagram - PDFA sturen2.png|Use case diagram PFD/A sturen]]
+
[[Bestand:UC_1.png|UC_1]]
 +
 
 +
<font size = "1">'''Use case diagram PDF/A sturen</font>
 +
 
 +
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.
 +
 
 +
[[Bestand:UC_2.png|UC_2]]
  
 
<font size = "1">'''Use case diagram PDF/A sturen</font>
 
<font size = "1">'''Use case diagram PDF/A sturen</font>

Huidige versie van 20 jul 2020 om 00:59



PDF/A
Naar medmij.nl
AfsprakenstelselFunctioneelTechnischAfspraken-Functioneel-Technisch

1 Inleiding

1.1 Algemeen

Voor de uitwisseling van documentgebaseerde, ongestructureerde medische gegevens of gezondheidsinformatie gebruikt MedMij de PDF/A-standaard. PDF/A is een ISO-gestandaardiseerde variant van het gewone PDF-formaat. Het formaat is specifiek ontwikkeld voor correcte weergave van de inhoud op langere termijn. Het beoogt statische paginainhoud weer te geven en is geschikt voor het opslaan van digitale documenten waar inhoud en context niet meer van mag veranderen. Zo kunnen patiënt en zorgverlener alvast allerlei ongestructureerde gezondheidsinformatie uitwisselen zonder te hoeven wachten tot dat deze gestructureerd opgeleverd kunnen worden. De standaard PDF/A kent de use cases Raadplegen en Sturen. Algemene informatie betreffende use cases kan gevonden worden op de pagina Ontwerpen MedMij.

1.2 Doelgroep

De doelgroep voor deze pagina wijkt niet af van de algemene doelgroep van de MedMij functionele ontwerpen.

1.3 Kaders en uitgangspunten

1.3.1 Richtlijn

Geen nadere specificatie, anders dan genoemd in de algemene inleiding van de MedMij functionele ontwerpen.

1.3.2 Infrastructuur

Geen nadere specificatie, anders dan genoemd in de algemene inleiding van de MedMij functionele ontwerpen.

1.3.3 Geografische reikwijdte

Geen nadere specificatie, anders dan genoemd in de algemene inleiding van de MedMij functionele ontwerpen.

1.4 Kwalificatie

1.4.1 Introductie

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 Use Cases

Deze sectie vervolgt met de volgende use cases:

2.1 Use case: Raadplegen gezondheidsinformatie in PDF/A door patiënt

2.1.1 Doel en relevantie

Het voor patiënten mogelijk maken regie op hun eigen gezondheid te nemen door inzicht te geven in medische informatie die over henzelf gaan. Het is niet mogelijk om alle medische informatie direct gestructureerd te kunnen ontsluiten voor de patiënt. Dit ontwerp beschrijft het uitwisselen van ongestructureerde digitale informatie in een PDF/A format.

2.1.2 Domein

Documenten en ongestructureerde medische informatie in een PDF/A formaat in het domein van zorgaanbieders en patiënten.

2.1.3 Context

Het gaat om het elektronisch beschikbaar maken van medische gegevens in PDF/A formaat vanuit een zorgaanbiederssysteem (XIS) naar een 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.

2.1.4 Informatie

2.1.4.1 Raadplegen medische gegevens in PDF/A

Het raadplegen van een medische informatie gaat van een specifieke patiënt naar een specifieke organisatie in de zorg (bijvoorbeeld een zorgaanbieder).

Informatie elementen in de vraag om PDF/A documenten staan hieronder. Dit betreft de filtermogelijkheden (query paramaters) in de vraag om documentgegevens. Deze filtermogelijkheden zijn afgeleid van het IHE MHD profiel.

  • patient
  • periode (startdatum - einddatum)
  • auteur
  • type document
  • categorie
  • status
  • setting (aanvullende details over waar de content is gemaakt / specialisme)
  • medische handelingen (belangrijkste uitgevoerde medische handelingen)

2.1.4.2 Beschikbaarstellen medische gegevens in PDF/A

De informatie-elementen voor het beschikbaarstellen van een PDF/A worden beschreven in het IHE MHD profiel. Dit betreft de inhoud van de transactie waarbij het om de volgende HL7 FHIR STU3 informatie modellen en Zorginformatiebouwstenen gaat:

2.1.5 Bedrijfsrollen

Deze use case kent twee bedrijfsrollen.

Bedrijfsrol Activiteit
Patiënt Wil medische gegevens in PDF/A formaat raadplegen
Zorgaanbieder Stelt medische gegevens in PDF/A formaat beschikbaar

Bedrijfsrollen afspraak inzien

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

Activiteitendiagram PFD/A raadplegen

Activiteitendiagram PDF/A raadplegen

2.1.6 Procesbeschrijving

2.1.6.1 'Patient journey' - Roos Dalstra

Het verhaal van de 'patient journey' van Roos vindt u hier. Hieronder een voor Roos relevante situatie waarbij het raadplegen van een PDF/A document rol speelt.

Na het ontslag komt de informatie over de opnameperiode vanuit het ziekenhuis beschikbaar in de PGO, zodat zij een goed beeld heeft van haar opname en haar medicatie. Dit kan zij ook delen met haar naasten.

Roos zou in haar PGO bijvoorbeeld de ontslagbrief van haar opname kunnen opvragen.

2.1.6.2 Proces

Het stuk van het proces waar het in deze use case om gaat is:

  • Het systeem van een zorgaanbieder (XIS) stelt de PDF/A beschikbaar aan het systeem van een patiënt (PGO).

Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.

2.1.6.2.1 Preconditie

De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van medische gegevens in PDF/A tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

De patiënt wil zijn medische gegevens inzien en de zorgaanbieder stelt dit ook beschikbaar.

Een patiënt kan steeds zelf het initiatief nemen om zijn medische gegevens op te halen, maar het is ook mogelijk dat een PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de beschrijving van deze use case geen verschil.
2.1.6.2.2 Proces stappen
  • Het systeem van de patiënt (PGO) vraagt om beschikbare medische gegevens bij een XIS aan de hand van een zoekopdracht.
  • Het systeem van de zorgaanbieder (XIS) levert een lijst met metadata over de gevonden PDF/A documenten op voor de patiënt.
  • De Patiënt gebruikt de persoonlijke gezondheidsomgeving om de gewenste PDF/A te raadplegen of te downloaden.
  • Het systeem van de zorgaanbieder (XIS) levert de PDF/A op voor de patiënt.
2.1.6.2.3 Post conditie

De patiënt heeft zijn medische gegevens geraadpleegd via de persoonlijke gezondheidsomgeving.

2.1.7 Systemen & Systeemrollen

Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:

  • PGO (patiënt)
  • XIS (zorgaanbieder)

Deze systemen hebben meerdere systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

Syteem Naam systeemrol Afkorting Omschrijving
PGO PDFAMetadataLijstRaadplegend MM-1.2.3-PLR-FHIR Raadplegen PDF/A metadata lijst bij zorgaanbieder
PDFARaadplegend MM-1.2.3-PDR-FHIR Raadplegen PDF/A document bij zorgaanbieder
XIS PDFAMetadataLijstBeschikbaarstellend MM-1.2.3-PLB-FHIR Beschikbaarstellen PDF/A metadata lijst bij patient
PDFABeschikbaarstellend MM-1.2.3-PDB-FHIR Beschikbaarstellen PDF/A document bij patient

Zie ook onderstaande afbeelding.

Componenten diagram PDF/A raadplegen

Componenten diagram PDFA raadplegen

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

Transactiegroep Transactie Systeemrol Systeem Bedrijfsrol Technisch
PDFA metadata lijst (PULL) Raadplegen PDF/A metadata lijst MM-1.2.3-PLR-FHIR PGO Patiënt PDF/A in FHIR
Beschikbaarstellen PDF/A metadata lijst MM-1.2.3-PLB-FHIR XIS Zorgaanbieder
PDFA (PULL) Raadplegen PDF/A MM-1.2.3-PDR-FHIR PGO Patiënt
Beschikbaarstellen PDF/A MM-1.2.3-PDB-FHIR XIS Zorgaanbieder

2.1.9 Use case diagram

Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

Use case diagram BGZ raadplegen

Use case diagram BGZ Raadplegen

2.2 Use case: Sturen gezondheidsinformatie in PDF/A door patiënt

2.2.1 Doel en relevantie

Het voor patiënten mogelijk maken regie op hun eigen gezondheid te nemen door gezondheidsinformatie te delen met zorgverleners. Het is niet mogelijk om alle informatie direct gestructureerd te kunnen sturen. Dit ontwerp beschrijft het uitwisselen van ongestructureerde digitale informatie in PDF/A formaat.

2.2.2 Domein

Documenten en ongestructureerde gezondheidsinformatie in een PDF/A formaat in het domein van zorgaanbieders en patiënten.

2.2.3 Context

Het gaat om het elektronisch beschikbaar maken van een document of documenten in PDF/A formaat vanuit een persoonlijke gezondheidsomgeving (PGO) naar zorgaanbiederssysteem (XIS). 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.

2.2.4 Informatie

De informatie-elementen die van toepassing zijn voor de standaard PDF/A Sturen, zijn gedefinieerd op het platform ART-DECOR in het project Documentuitwisseling.

2.2.4.1 Sturen van gezondheidsinformatie in PDF/A

Het sturen van een gezondheidsinformatie gaat van een specifieke patiënt naar een specifieke organisatie in de zorg (bijvoorbeeld een zorgaanbieder).

Om uitwisseling van PDF/A-bestanden tot stand te brengen, neemt MedMij zoveel mogelijk over van het MHD-profiel (Mobile access to Health Documents) van IHE (Integrating the Healthcare Enterprise) dat een RESTful / HTTP-interface definieert naar een XDS-omgeving met behulp van HL7 FHIR STU3-bronnen. De informatie-elementen voor het beschikbaarstellen van een PDF/A worden beschreven in het IHE MHD-profiel.

De inhoud van de transactie gaat om de volgende HL7 FHIR STU3 informatie modellen en Zorginformatiebouwstenen:

2.2.5 Bedrijfsrollen

Deze use case onderscheidt twee bedrijfsrollen, namelijk de Patiënt en de Zorgaanbieder zoals te zien in onderstaande tabel.

Bedrijfsrol Activiteit
Patiënt Wil gezondheidsinformatie in PDF/A formaat sturen
Zorgaanbieder Ontvangt gezondheidsinformatie in PDF/A formaat

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

AC_enkel_3

Activiteitendiagram PDF/A sturen

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

AC_dubbel_2

Activiteitendiagram PDF/A sturen

2.2.6 Procesbeschrijving

2.2.6.1 'Patient journey' - Roos Dalstra

Een voorbeeldsituatie die de meerwaarde schetst van het sturen van PDF/A vanuit het PGO is de 'patient journey' van Roos Dalstra. Hieronder een voor Roos relevante situatie waarbij het sturen van een PDF/A document rol kan spelen.

Roos is ’s nachts vanwege benauwdheid opgenomen op de afdeling cardiologie van het ziekenhuis. De internist in dienst die nacht wil graag weten welke medicatie Roos gebruikt. Aangezien Roos alles heeft bijgehouden in haar persoonlijke gezondheidsomgeving kan zij het ziekenhuis haar medicatiegegevens laten zien door deze te sturen naar het ziekenhuisinformatiesysteem.

Wanneer het XIS niet in staat is om het medicatieoverzicht gestructureerd te ontvangen, zou het PGO het medicatieoverzicht in een PDF/A kunnen sturen. Zo heeft de arts wel gelijk de beschikking over het medicatieoverzicht.

2.2.6.2 'Patient journey' - Jelmer Postma

Een tweede voorbeeld waarbij de meerwaarde van raadplegen en sturen van PDF/A vanuit het PGO is de 'patient journey' van Jelmer Postma. Hieronder een voor Jelmer relevante situatie waarbij het sturen van een PDF/A document rol kan spelen.

De opname in de GGZ-instelling is van korte duur. Vanaf nu wordt Jelmer ambulant behandeld door een reguliere GGZ-instelling.

Vanuit zijn zorgtraject heeft Jelmer verschillende plannen en verslagen in zijn PGO opgeslagen. Onder andere het initiële plan van de bedrijfsarts en het behandelplan van de psychiater kan Jelmer raadplegen in zijn PGO. De verslagen kan Jelmer als PDF/A sturen aan (nieuwe) begeleiders zodat alle betrokkenen de informatie rond Jelmer zijn ziekte hebben, waarmee zijn herstel zo spoedig mogelijk kan verlopen.

2.2.6.3 Proces

Het stuk van het proces waar het in deze use case om gaat is:

  • Het systeem van een patiënt (PGO) stuurt de PDF/A naar het systeem van een zorgverlener (XIS).

Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.

2.2.6.3.1 Preconditie

De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van gezondheidsinformatie in PDF/A tussen eigen persoonlijke gezondheidsomgeving en het betreffende XIS.

De patiënt wil zijn gezondheidsinformatie sturen en de zorgaanbieder ontvangt deze.

Een patiënt kan steeds zelf het initiatief nemen om zijn gezondheidsinformatie te sturen.
2.2.6.3.2 Proces stappen
  • Het systeem van de patiënt (PGO) stuurt gezondheidsinformatie in PDF/A formaat naar een XIS.
  • Het systeem van de zorgaanbieder (XIS) ontvangt een PDF/A van de patiënt.
2.2.6.3.3 Post conditie

De patiënt heeft zijn gezondheidsinformatie in PDF/A formaat gestuurd via de persoonlijke gezondheidsomgeving.

2.2.7 Systemen & Systeemrollen

Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:

  • PGO (patiënt)
  • XIS (zorgaanbieder)

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om een document of documenten PDF/A van patiënt naar zorgaanbieder. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

Syteem Naam systeemrol Afkorting Omschrijving
PGO DocumentcollectieSturend MM-2.0.0-DCS-FHIR Sturen PDF/A document naar zorgaanbieder
XIS DocumentcollectieOntvangend MM-2.0.0-DCO-FHIR Ontvangen PDF/A document van de patiënt

Zie ook onderstaande afbeelding.

component_1

Componenten diagram PDF/A Sturen

Zie ook onderstaande afbeelding.

component_2

Componenten diagram PDF/A Sturen

2.2.8 Transacties en 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.

Transactiegroep Transactie Systeemrol Systeem Bedrijfsrol Technisch
PDFA (PUSH) Sturen PDF/A Document(en) MM-2.0.0-DCS-FHIR PGO Patiënt PDF/A in FHIR
Ontvangen PDF/A Document(en) MM-2.0.0-DCO-FHIR XIS Zorgaanbieder

2.2.9 Use case diagram

Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

UC_1

Use case diagram PDF/A sturen

Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

UC_2

Use case diagram PDF/A sturen

3 Functionaliteit

3.1 Raadplegen

PGO raadpleegt als eerste bij het XIS, de index met referenties naar documenten. PGO raadpleegt in zijn tweede stap de documenten via deze referenties onder dezelfde condities - met name autorisatie- als de raadpleging van de index. Het XIS is gehouden aan de controle van deze condities. De referenties in de index moeten dus leiden naar een locatie die onder controle staat van het betreffende XIS. Om deze controlemogelijkheid af te dwingen kan het nodig zijn dat het XIS de referentie naar het werkelijke document in opgehaalde indexgegevens vervangt door een alternatieve referentie die onder controle staat bij het XIS. Voor een PGO is een eventuele vervangen referentie transparant: het blijft een referentie die het systeem kan volgen onder dezelfde condities als het indexgegeven zelf.

De transactie "Raadplegen PDF/A" door de PGO volgt de (aangepaste) referentie naar het document. Het raadplegen via het XIS is om context en controle te houden.

3.2 Sturen

Bij Sturen van PDF/A door een PGO worden de PDF/A documenten direct in het bericht als een (binair) bestand meegezonden. Er wordt dus niet gewerkt met referenties zoals bij Raadplegen PDF/A het geval is.

De XIS zal het bericht ontvangen en het PDF/A afleveren bij de Ontvanger (vaak de zorgverlener) die in het bericht is opgenomen. Hoe het afleveren aan de XIS kant van de PDF/A naar een zorgverlener plaatsvindt wordt niet door de informatiestandaard bepaald.

4 Verantwoordelijkheid voor informatie

Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

5 Afschermen van gegevens

Er zijn geen afspraken over het afschermen van gegevens.

6 Infrastructuur

Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

7 Referenties

Auteur(s) Titel Versie Datum Bron Organisatie
- Mobile access to Health Documents (MHD) - 10-05-2019 (wijzigingsdatum) Mobile access to Health Documents (MHD) Integrating the Healthcare Enterprise (IHE)
- FHIR STU 3 Resource Index FHIR STU 3 (v3.0.1) 19-04-2017 Resource Index Hl7
- Zorginformatie bouwstenen ZIB Publicatie 2017(NL) 23-12-2018 (wijzigingsdatum) Zorginformatie bouwstenen Nictiz

8 Bijlage: Documenthistorie

8.1 Release notes

In onderstaande tabel staan de wijzigingen voor deze informatiestandaard. Zie de Ontwerpen landingspagina voor wijzigingen die op alle informatiestandaarden van toepassing zijn.

Release Versie BITS issue Omschrijving
2019.01 - September 1.2.3 MM-335 Verwijzing naar het IHE MHD pdf document gaat nu naar de STU3 versie i.p.v. de laatste versie (o.b.v. R4)
2018.06 1.1.0 MM-49 Beschikbaarstellen van referenties alleen via dezelfde geraadpleegde resourceserver met de benodigde autorisatie.

8.2 Paginahistorie

Release Datum Omschrijving
2019.01 10-02-2019
  • Use case PDF/A Sturen toegevoegd.
2019.01 28-03-2019
  • Versienummer systeemrolcodes ophogen met 1 patchnummer.
2019.01 11-03-2019
  • Wijzigingen gepubliceerd in versie 2019.01, zie release notes.
  • Verplaatsing release notes naar functionele pagina.
2018.06 15-10-2018
  • Functionaliteit toegevoegd voor BITS issue MM-49.
  • Systeemrollen versie van 1.0.0. naar 1.1.0.
2018.06 15-10-2018
  • Documenthistorie toegevoegd.
  • Versie toegevoegd in de titel.