Brontekst bekijken van MedMij:Vprepub-2019.01 OntwerpBeelden

__NUMBEREDHEADINGS__
{{#customtitle:Functioneel Ontwerp Beelden}}
{{MedMij:V2019.01_Issuebox}}
{{IssueBox|Deze standaard is in ontwikkeling. Feedback van de openbare consultatie tussen 10-01-2019 en 21-02-2019 wordt nog doorgevoerd.}}


[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:beeldenIcoon.png|link=|87px |links||media]]
<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:V2019.01_Ontwerpen|Functioneel]]                
circle 1787 230 212 [[MedMij:V2019.01_FHIR_Images|Technisch]]                
desc none                    
</imagemap>


=Inleiding= 
==Algemeen==
Deze pagina beschrijft het functioneel ontwerp voor de uitwisseling van beelden binnen MedMij. De algemene inleiding van de MedMij functionele ontwerpen kan [[MedMij:V2019.01_Ontwerpen| hier]] gevonden worden.

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

==Kaders en uitgangspunten==
===Richtlijn===
Geen nadere specificatie, anders dan genoemd in [[MedMij:V2019.01_Ontwerpen#Richtlijn| de algemene inleiding]] van de MedMij functionele ontwerpen.

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

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

==Kwalificatie==
{{#lst:MedMij:V2019.01_Kwalificatie|medmij_kwalificatie_introductie}}

=Use Cases=
==Use case 1: Sturen beelden vanuit een PGO==
=== Doel en relevantie ===
Het voor patiënten mogelijk maken regie op hun eigen gezondheid te nemen door beelden te sturen naar (verschillende) zorgaanbieders.

=== Domein ===
Beelden in het domein van zorgaanbieders en patiënten.

=== Context ===
Het gaat om het elektronisch en gestructureerd sturen van beelden vanuit een [[#persoonlijke-gezondheidsomgeving|persoonlijke gezondheidsomgeving]] (PGO) naar een 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.

=== Informatie === 
Bij het sturen van beelden gaat het om de volgende informatie die uitgewisseld wordt: 
# de beelden
# bijbehorende meta-informatie per beeld
# mogelijk een begeleidende tekst

De beelden kunnen gemaakt zijn door de patiënt, een zorgaanbieder of iemand anders. Deze use case gaat ervan uit dat er reeds afspraken bestaan tussen de patiënt en zorgverlener betreffende het sturen van beelden. Daarbij ondersteunt deze use case geen interactie met de patiënt middels het PGO. De zorgverlener dient buiten deze use case om de beelden te bespreken met de patiënt. 

==== 1. Beeld gegevensformaten en grootte====
De volgende gegevensformaten dienen te worden ondersteund: JPEG, PNG, GIF en JP2. Dit zijn ook de gegevensformaten, bestaande uit één frame, die door [[#DICOM-beeldformaten|DICOM standaard]] worden gespecificeerd voor gebruik bij DICOM web-services. Binnen deze use case zijn dit de enige gebruikte gegevensformaten voor beelden. 

Beelden mogen extra (meta)informatie bevatten in bijvoorbeeld de [[#Exif|Exif standaard]]. Een voorbeeld is het opslaan van patiëntgegevens binnen het beeldformaat JPEG. Hier wordt in deze use case echter geen gebruik van gemaakt.

Een beeld is maximaal 10 MB, base 64 encoded. Effectief is een beeld niet groter dan 7.5 MB. 

Een PGO kan één of meerdere beelden tegelijk sturen.

==== 2. Meta-informatie ====
Het beeld dient te worden voorzien van voldoende meta-informatie om door het ontvangende systeem goed te kunnen worden geïnterpreteerd én geïndexeerd in een XDS omgeving. Deze use case gaat uit van uitwisseling met zowel XISen aangesloten op een XDS netwerk alswel XISen die dat niet zijn. De essentie is dat een PGO altijd de minimale benodigde meta-informatie stuurt om met alle XISen te kunnen uitwisselen. Het correct indexeren van de beelden in een XDS netwerk is de verantwoordelijkheid van het ontvangende XIS. Het technische ontwerp geeft ondersteuning middels een mapping van het FHIR bericht naar XDS concepten en het IHE MHD profiel.

Veel van de benodigde meta-informatie kan geautomatiseerd/gegenereerd worden door het PGO (en XIS voor XDS indexatie). Vrijwel alle verplichte meta-informatie elementen zou een PGO voor de patiënt kunnen genereren in deze use case. Dit wordt weergegeven in de onderstaande twee tabellen. 

In de tabellen wordt een overzicht gegeven van alle verplichte ''variabele'' informatie-elementen die een PGO dient te sturen behorend bij een beeld. Daarnaast worden ook optionele informatie-elementen weergeven. De eerste tabel beschrijft de meta-informatie elementen behorende bij een enkel beeld, de tweede tabel betreft de meta-informatie voor een collectie beelden. De vierde kolom geeft aan of de PGO of de Patiënt verantwoordelijk is voor het aanbieden van het betreffende informatie-element.

{| class="wikitable"
! Meta-informatie elementen voor één beeld
! Omschrijving
! Verplicht element
! Verantwoordelijk voor informatie
|-
| Patiënt
| Patiënt waar het beeld betrekking op heeft.
| Ja
| PGO
|-
| DatumTijd
| DatumTijd van het beeld. We willen niet dat de patiënt de datum en/of de tijd kan aanpassen. Soms komt het voor dat datum/tijd verkeerd is ingesteld op het apparaat. De zorgverlener kan dan navraag doen bij de patiënt. Eventueel kan de patiënt in veld toelichting aangeven op welk moment het beeld is gemaakt.
| Ja
| PGO
|-
| Beeldbestand/ mediabestand
| Het beeldbestand dat de patiënt wil sturen. In deze release spreken we over beeldbestand omdat in deze release enkel beelden verstuurd kunnen worden. zie beeldformaat voor meer info.
| Ja
| Patiënt
|-
| Beeldformaat
| Beeldformaat (JPEG / PNG / GIF / JP2). In de eerste release worden slechts een beperkt aantal beeldformaten ondersteund. Video wordt nog niet ondersteund. Het beeldformaat wordt in het bericht mee gestuurd, omdat een beeld als binary wordt verstuurd. De ontvangende partij weet op basis van het beeldformaat hoe de binary geopend moet worden.
| Ja
| PGO
|-
| Grootte
| Grootte van het beeld in bytes.
| Ja
| PGO
|-
| Toelichting
| Een toelichting op het beeld.
| Nee
| Patiënt
|-
| Reden
| De reden waarom de foto genomen is, gegeven middels een code of in vrije tekst.
| Nee
| Patiënt
|-
| AnatomischeLocatie
| De anatomische locatie waar het beeld betrekking op heeft bij de patiënt.
| Nee
| Patiënt
|-
| Auteur
| De persoon die het beeld gemaakt heeft.
| Nee
| Patiënt
|-
| Titel
| Omschrijvende naam van het beeld.
| Nee
| PGO - Patiënt indien er geen bestandsnaam beschikbaar is.
|}

{| class="wikitable"
! Meta-informatie elementen voor collectie beelden
! Omschrijving
! Verplicht element
! Verantwoorlijk voor informatie
|-
| Status
| Status van de collectie (huidig, verouderd, invoerfout).
| Ja
| PGO
|-
| Patiënt
| Patiënt waar de collectie beelden betrekking op heeft.
| Ja
| PGO
|-
| Toelichting
| Een toelichting op de collectie beelden.
| Nee
| Patiënt
|-
| DatumTijd
| DatumTijd van wanneer de collectie is samengesteld.
| Nee
| PGO
|-
| Titel
| Omschrijvende naam van de collectie beelden.
| Nee
| Patiënt
|}

==== 3. Begeleidende tekst ====
De Patiënt kan per beeld en/of per collectie beelden een begeleidende tekst meegeven. Dit gaat middels de 'toelichting' meta-informatie elementen.

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

{| class="wikitable" "cellpadding="10" width="100%"
! 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 beelden sturen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Wil beelden ontvangen
|}
<font size = "1">'''Bedrijfsrollen sturen beelden'''</font>

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Sturen_Beelden.png|Activiteitendiagram sturen beelden]]

<font size = "1">'''Activiteitendiagram sturen beelden'''</font>

=== Procesbeschrijving ===
==== Patient Journey – Thomas van Beek ==== 
Een voorbeeldsituatie die de meerwaarde van het sturen van beelden vanuit het PGO schetst is de patient journey van [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf Thomas van Beek].  
<blockquote>Voorafgaand aan de reguliere controle van diabetes type 1 vraagt de diabetesverpleegkundige structureel of Thomas een korte vragenlijst wil invullen over ervaren kwaliteit van leven en ziektelast. Thomas heeft echter exact dezelfde vragenlijst 1 week geleden al ingevuld bij de huisarts voor een ander consult en is er sindsdien niets veranderd. Via het patiënten portaal van de huisarts opent Thomas de vragenlijst en maakt er een foto van. Na het uploaden stuurt Thomas deze foto vanuit zijn PGO naar  de diabetesverpleegkundige.</blockquote>

==== Patient Journey – Kenneth van Someren ====
Een tweede voorbeeld waarbij de meerwaarde van het sturen van beelden vanuit het PGO geschetst kan worden is de patient journey van [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Kenneth_van_Someren_MedMij.pdf Kenneth van Someren]. 

<blockquote>De grote antieke stoel in de woonkamer is het plekje waar Kenneth thuis graag te vinden is. De stoel begon echter de laatste tijd steeds minder lekker te zitten. De zuster adviseert regelmatig af te wisselen met de bank, maar de televisie is lang niet zo interessant als het dorpsplein aan de overkant van de straat. Het begon met enkel een klein rood plekje op zijn ruggengraat, maar inmiddels begon dit vormen aan te nemen die ook dochter Debby zorgen baarde. Na kort overleg met de thuiszorg besluit ze telefonisch contact op te nemen met de wondverpleegkundige van de organisatie. Deze vraagt om een duidelijke foto te maken en via het PGO te sturen voor beoordeling. De volgende ochtend komt de thuiszorg met de juiste kennis en materialen om de wond te behandelen.</blockquote>

==== Proces ====
Het stuk van het proces waar het in deze use case omgaat is:
* Patiënt en zorgverlener maken de afspraak dat de patient een beeld kan sturen aan de zorgverlener.
* Patiënt maakt, ontvangt of downloadt één of meerdere beelden en uploadt deze naar zijn PGO.
* Patiënt heeft de mogelijkheid om een begeleidende tekst van maximaal 1 MB toe te voegen aan het beeld en/of beelden.
* Het PGO stuurt de beelden naar het systeem van de zorgaanbieder.
** Mogelijk moet of kan de patiënt metagegevens behorende bij de beelden aanvullen of invullen.
* De zorgaanbieder raadpleegt de beelden in zijn eigen dossier (XIS).
* De zorgverlener bespreekt het beeld buiten het PGO om met de patiënt. Deze use-case ondersteunt geen interactie met de patiënt middels het PGO.

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 beelden tussen het eigen PGO en de betreffende XIS.
* De patiënt en zorgaanbieder hebben onderling afspraken gemaakt over het sturen van beelden.
* Het XIS van de zorgaanbieder is in staat afbeeldingen van de patient te ontvangen.
* De beelden bevinden zich in het PGO.

===== Proces stappen ===== 
* Het systeem van de patiënt (PGO) stuurt de beelden naar het systeem van de zorgaanbieder (XIS).
* Het systeem van de zorgaanbieder (XIS) ontvangt de beelden van het PGO. 

===== Post conditie ===== 
* Indien het systeem van de zorgaanbieder (XIS) gebruik maakt van een XDS omgeving zal dit systeem de beelden op gepaste wijze in het netwerk registreren.
* De zorgaanbieder gebruikt het systeem (XIS) om de beelden te kunnen zien en/of beoordelen.

=== Systemen & Systeemrollen ===
Zowel de persoon als de zorgaanbieder maken ieder 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 beelden van de persoon naar de zorgaanbieder. 

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| Sturen van Beelden 
| style="background-color: white;"| MM-1.0.0-BES-FHIR
| style="background-color: white;"| Sturen van beelden naar zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Ontvangen van Beelden
| style="background-color: white;"| MM-1.0.0-BEO-FHIR
| style="background-color: white;"| Ontvangen van beelden vanuit het PGO
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Sturen_Beelden_(Totaal).png|Componenten diagram]]

<font size = "1">'''Componenten diagram van systemen en systeemrollen'''</font>

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

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:middle;" rowspan="2"|Beelden (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen Beelden
|style="background-color: white;vertical-align:top;"|MM-1.0.0-BES-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:V2019.01_FHIR_Images |Beelden in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Ontvangen Beelden
|style="background-color: white;vertical-align:top;"|MM-1.0.0-BEO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Sturen_Beelden.png|Use case diagram Sturen Beelden]]

<font size = "1">'''Use case diagram sturen beelden</font>

=Functionaliteit=

== Eisen en wensen ==
*Er zijn op dit moment geen functionele aanwijzingen/eisen voor de systemen geformuleerd.

== Niet functionele eisen en wensen ==
*'''Hash-functie in FHIR media resource'''
**De hash is een optioneel veld.
**sha-1, base64ed
**Zie voor meer uitleg hier: http://hl7.org/fhir/datatypes-definitions.html#Attachment.hash

=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;"| <span id="persoonlijke-gezondheidsomgeving">-</span>
| style="background-color: white;"| Persoonlijke Gezondheidsomgeving
| style="background-color: white;"| 
| style="background-color: white;"| 06-12-2018
| style="background-color: white;"| https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/
| style="background-color: white;"| Patiëntenfederatie Nederland
|-
| style="background-color: white;"| <span id="DICOM-beeldformaten">-</span> 
| style="background-color: white;"| Rendered Media Types
| style="background-color: white;"| 
| style="background-color: white;"| 10-12-2018
| style="background-color: white;"| http://dicom.nema.org/medical/dicom/2017d/output/html/part18.html#table_6.1.1-3
| style="background-color: white;"| NEMA (DICOM)
|-
| style="background-color: white;"| <span id="Exif">-</span> 
| style="background-color: white;"| Exif
| style="background-color: white;"| 
| style="background-color: white;"| 10-12-2018
| style="background-color: white;"| https://en.wikipedia.org/wiki/Exif
| style="background-color: white;"| Wikipedia
|}




<font size = "1">'''Referenties</font>

=Bijlage: Documenthistorie=

==Release notes==

In onderstaande tabel staan de wijzigingen voor deze informatiestandaard. Zie de [[MedMij:V2019.01_Ontwerpen#Release_Notes|Ontwerpen landingspagina]] voor wijzigingen die op alle informatiestandaarden van toepassing zijn.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Release
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS issue
!style="width:850px; text-align:left;"|Omschrijving
|-
| style="background-color: white;"| 
| style="background-color: white;"| 
| style="background-color: white;"| 
| style="background-color: white;"| 
|-
| style="background-color: white;"| 
| style="background-color: white;"| 
| style="background-color: white;"| 
| style="background-color: white;"| 
|}

==Paginahistorie==
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| -
| style="background-color: white;"| 27-02-2019
| style="background-color: white;"| MSIOC-20 - Aanpassing patient journey 
|-
| style="background-color: white;"| -
| style="background-color: white;"| 21-01-2019
| style="background-color: white;"| 
* MSIOC-2 - Taal- en typfoutjes 
* MSIOC-3 - Preconditie ontbeert beelden 
* MSIOC-4 - Proces stappen bevat irrelevante punten
|-
| style="background-color: white;"| -
| style="background-color: white;"| 28-12-2018
| style="background-color: white;"| 
* Aanpassing patient journey.
* Verplaatsing release notes naar functionele hoofdpagina.
|-
| style="background-color: white;"| -
| style="background-color: white;"| 27-12-2018
| style="background-color: white;"| 
* Aanpassing naamgeving van de informatiestandaard voor consistentie: van beeld naar beelden en van versturen naar sturen.
* Verwerking feedback.
* Herschreven en aanvulling van de paragraaf 'Informatie'.
|-
| style="background-color: white;"| -
| style="background-color: white;"| 10-12-2018
| style="background-color: white;"| Toevoeging van specificaties bij de sectie 'Informatie' o.b.v. antwoorden uit de verkenning.
|-
| style="background-color: white;"| -
| style="background-color: white;"| 06-12-2018
| style="background-color: white;"| Conceptversie, inclusief afbeeldingen, op wiki verwerkt.
|-
| style="background-color: white;"| -
| style="background-color: white;"| 28-11-2018
| style="background-color: white;"| Eerste conceptversie
|}