1. Inleiding
Dit is de weergaverichtlijn voor gegevensdienst Verzamelen Documenten 3.0 (pdf/a) (MedMij gegevensdienst 51).
Het document bevat mock-ups die bedoeld zijn ter inspiratie. Persoonlijke gezondheidsomgevingen (PGO’s) kunnen deze voorbeelden naar eigen inzicht visueel vormgeven, zolang de gebruiksvriendelijkheid behouden blijft.
1.1 Doel weergaverichtlijn
Het bieden van duidelijke handvatten voor een gebruikersvriendelijke en begrijpelijke weergave van documenten in PGO's. De richtlijn ondersteunt ontwikkelaars en zorgverleners bij het:
-
gebruiken van begrijpelijke, gebruiksvriendelijke termen en toelichtingen
-
structureren en presenteren van een overzicht van gegevens op een manier die aansluit bij de informatiebehoefte van PGO gebruikers
-
de richtlijn geeft géén handvatten voor de vormgeving (kleur, vorm, lettertype, etc.) van gegevens
1.2 Scope van de weergaverichtlijn
Richting geven aan hoe de MedMij gegevensdienst Verzamelen documenten 3.0 weergegeven kan worden in de PGO.
De richtlijn is ontwikkeld voor gegevens die verzameld worden via de Verzamelen documenten 3.0 MedMij-gegevensdienst. Gegevens die via andere MedMij-gegevensdiensten verzameld worden in de PGO zijn hierin niet meegenomen.
1.3 Beheer van de weergaverichtlijn
De eigenaar van deze richtlijn is Stichting MedMij. Voor vragen of opmerkingen over de richtlijn kan contact opgenomen worden met stichting Medmij via info@medmij.nl.
2. Inhoud van de richtlijn
2.1 Weergave in de PGO
Het inloggen en authentiseren bij de zorgaanbieder is niet opgenomen in deze richtlijn.
De gebruiker gaat in de PGO naar het documentoverzicht en/of zorgorganisatie-documentoverzicht waar de opgehaalde documenten getoond worden.
2.1.1 Overzichtsscherm documenten
Er zijn twee weergaven gedefinieerd voor het overzicht van de documenten:
-
Scenario 1: Documentoverzicht (met alle documenten van alle zorgaanbieders in één overzicht)
-
Scenario 2: Zorgorganisatie-documentoverzicht (met alle documenten van één zorgaanbieder in één overzicht)
De twee scenario’s, hieronder uitgewerkt, geven weer hoe een UX design getoond kan worden. Een PGO is vrij om 1 of beide van deze scenario’s te ondersteunen.
De richtlijn gaat ervan uit dat PGO’s een responsief ontwerp ondersteunen. In deze richtlijn worden voorbeeldweergaven van een mobiel (smartphone) en een desktop (laptop) getoond.
2.1.1.1 Documentoverzicht
Desktop weergave
Mobiel weergave
|
Nr |
Acceptatiecriteria |
|---|---|
|
1 |
Standaard worden alle beschikbaar gestelde documenten van de geraadpleegde zorgaanbieders weergegeven, gesorteerd op datum van jong naar oud. |
|
2 |
Je kunt zoeken op (delen van) de documentnaam of op informatie uit de andere datavelden in het overzichtsscherm. De datum vormt hierop een uitzondering, omdat hiervoor al een periode kan worden opgegeven. |
|
3 |
Voor de datavelden in het overzichtsscherm is het mogelijk om te filteren op één of meerdere waarden. De datum vormt hierop een uitzondering, omdat hiervoor al een periode kan worden opgegeven. Ook datavelden die leiden tot een te lange lijst van filterwaarden vormen een uitzondering. |
|
4 |
Voor het dataveld Gemaakt op kun je een specifieke periode selecteren. |
|
5 |
In het overzichtsscherm kan minimaal op datum worden gesorteerd, maar bij voorkeur is sorteren op alle datavelden mogelijk. |
|
6 |
De datavelden in het overzichtsscherm zijn begrijpelijk en gebruiksvriendelijk geformuleerd. Zie de paragraaf Tabel met specificaties voor de aanbevolen termen per opgehaald dataveld. In verband met beperkte schermruimte op mobiele apparaten mogen de labelnamen van de datavelden in het overzichtsscherm worden weggelaten. |
2.1.1.2 Zorgorganisatie-documentoverzicht
Desktop weergave
Mobiel weergave
|
Nr |
Acceptatiecriteria |
|---|---|
|
1 |
Standaard worden alle beschikbaar gestelde documenten van de geraadpleegde zorgaanbieder weergegeven, gesorteerd op datum van jong naar oud. |
|
2 |
Je kunt zoeken op (delen van) de documentnaam of op informatie uit de andere datavelden in het overzichtsscherm. De datum vormt hierop een uitzondering, omdat hiervoor al een periode kan worden opgegeven. |
|
3 |
Voor de datavelden in het overzichtsscherm is het mogelijk om te filteren op één of meerdere waarden. De datum vormt hierop een uitzondering, omdat hiervoor al een periode kan worden opgegeven. Ook datavelden die leiden tot een te lange lijst van filterwaarden vormen een uitzondering. |
|
4 |
Voor het dataveld Gemaakt op kun je een specifieke periode selecteren. |
|
5 |
In het overzichtsscherm kan minimaal op datum worden gesorteerd, maar bij voorkeur is sorteren op alle datavelden mogelijk. |
|
6 |
De datavelden in het overzichtsscherm zijn begrijpelijk en gebruiksvriendelijk geformuleerd. Zie de paragraaf Tabel met specificaties voor de aanbevolen termen per opgehaald dataveld. In verband met beperkte schermruimte op mobiele apparaten mogen de labelnamen van de datavelden in het overzichtsscherm worden weggelaten. |
2.1.1.3 Document Manifest
Het sterke advies is om geen DocumentManifest aan te roepen, maar uitsluitend DocumentReference, aangezien het DocumentManifest geen toegevoegde waarde biedt voor de gebruiker. Het gebruik van DocumentManifest is bovendien niet verplicht, maar facultatief. Wanneer een PGO toch gebruikmaakt van DocumentManifest, adviseren wij om de documenten uit het DocumentManifest op exact dezelfde manier te tonen in het overzichtsscherm als een document uit de DocumentReference.
2.1.2 Detailscherm van een document
Dit detail scherm krijg je te zien als je een specifiek document in het overzichtsscherm selecteert. De beeld-viewer wordt geopend als programma/app in de PGO.
PGO’s zijn vrij om al dan niet een extra detailscherm te tonen.
Desktop weergave
Grote weergave:
of kleine weergave (waarbij je een ander document uit het overzichtsscherm kan aanklikken):
Mobiel weergave
|
Nr |
Acceptatiecriteria |
|---|---|
|
1 |
Je kunt de pdf bekijken in de pdf-viewer van de PGO. Dit wil zeggen, je kunt de pdf bekijken, meteen in de viewer zonder uit de PGO applicatie te gaan. |
|
2 |
Je kunt de pdf downloaden in de pdf-viewer van de PGO. |
|
3 |
Je kunt inzoomen en uitzoomen in de pdf-viewer van de PGO. |
|
4 |
Je kunt door het document scrollen in de pdf-viewer van de PGO. |
2.2 Tabel met specificaties
In de tabel staan de gegevens, uit de gegevensdienst Verzamelen Documenten 3.0, die relevant zijn voor deze weergaverichtlijn weergegeven. (voor een volledig overzicht van de gegevens uit gegevensdienst Verzamelen Documenten 3.0, zie https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2020.01/OntwerpPDFA ).
De prioriteit van de te tonen datavelden wordt vastgesteld volgens de MoSCoW-methodiek. Datavelden die niet in de specificatietabel voorkomen, moeten worden beschouwd als datavelden met de letter W.
|
Prioriteit |
Omschrijving |
|---|---|
|
M(ust have) |
Nodig voor de basisfunctionaliteit van de toepassing en moet worden geïmplementeerd om het proces succesvol te laten verlopen. |
|
S(hould have) |
Belangrijke functionaliteit die niet vereist is, maar die voordelen biedt voor gebruikers en de algehele gebruikservaring. |
|
C(ould have) |
Gewenste functionaliteit die waarde toevoegt, maar minder kritisch is en indien nodig kan worden uitgesteld. |
|
W(on't have) |
Functionaliteiten die nu buiten scope zijn maar mogelijk in de toekomst worden overwogen. PGO’s hebben de vrijheid om deze datavelden desondanks toch te tonen. Het uitgangspunt is echter dat deze velden niet primair worden weergegeven, zodat de gebruiker deze informatie niet direct ziet. De gegevens zijn alleen beschikbaar wanneer de gebruiker hier expliciet naar zoekt of doorklikt, aangezien deze datavelden geen duidelijke meerwaarde hebben voor directe weergave. |
|
Naam data item |
Type data item |
Voorbeeld |
Advies waar te tonen in PGO |
Opmerkingen |
Advies tekst weergave in PGO |
Prioriteit (MoSCoW) |
|---|---|---|---|---|---|---|
|
DocumentReferentie |
Rootconcept |
|
|
|
|
|
|
Status |
Item |
Current |
|
Alleen documenten met status "Current" tonen in het overzichtsscherm. |
|
W |
|
Titel |
Item |
Pathologie verslag |
Overzichts scherm |
Zie 2.1.1 beslisboom: Weergaverichtlijn Verzamelen Documenten 3.0 (v0.3)
|
Document (of Documentnaam) |
M |
|
Type |
Item |
Pathologiedocumentatie |
Overzichtsscherm en/of detailscherm |
De Nederlandse lijst gebruiken. (niet in het Engels tonen). Deze kolom in het overzichtsscherm biedt meerwaarde wanneer de naam van het document (titel) niet duidelijk is. |
Documentsoort (of Soort) |
C |
|
Indexdatum |
Item |
01-01-2025 |
Overzichts scherm |
De datum wanneer de gegevens zijn opgeslagen. Niet de datum dat de pdf wordt opgehaald. |
Gemaakt op (of Datum) |
M |
|
Class |
Item |
Consult Note |
Detailscherm |
|
Groep (of Categorie) |
C |
|
Context |
Item |
Belconsult |
Detailscherm |
|
Achtergrond (of Context) |
C |
|
Author (Practioner) |
Reference |
J.X. van der Laan |
Overzichts scherm |
De naam van de zorgverlener tonen. Deze wordt in dezelfde kolom van het overzichtsscherm getoond als zorgaanbieder omdat dit veld niet altijd gevuld is. |
Gemaakt door (of Zorgverlener) |
Zorgverlener naam: S Overige datavelden: W |
|
Author (Organization) |
Reference |
BVO NL |
Overzichtsscherm |
Liefst geen afkortingen. (Bijvoorbeeld BVO NL = Bevolkingsonderzoek Nederland) |
Zorgorganisatie |
Organisatienaam: M Overige datavelden: W |
2.1.1 Beslisboom ten aanzien van het veld titel (documentnaam)
Deze beslisboom is opgesteld omdat de titel van het bestand (de documentnaam) in de praktijk regelmatig ontbreekt bij aanlevering.
De beslisboom is technisch en logisch gezien enigszins complex. Desondanks nemen we deze op in de weergaverichtlijn, omdat de huidige situatie als zeer gebruikersonvriendelijk wordt ervaren.
2.1.1.1 Beslisboom
Het betreft de velden die worden aangeleverd in de DocumentReference. Uit analyse bleek dat onderstaande volgorde in de meeste situaties het meest optimaal is.
Velden (in volgorde van prioriteit):
-
Content.title (technisch optioneel)
-
Description (technisch optioneel)
-
Type.text (technisch optioneel)
-
Type.coding.display (niet-LOINC) (technisch optioneel) (naast de LOINC-codelijst worden vaak ook eigen codelijsten meegeleverd die informatiever zijn dan de LOINC-codes)
-
Type.coding (LOINC) (technisch verplicht)
De beslisboom wordt van boven naar beneden doorlopen. Zodra een veld gevuld is, wordt deze waarde getoond. Onderliggende opties worden dan niet meer gebruikt. De eerste gevulde waarde bepaalt de documentnaam (Document / Documentnaam).
Voorbeelden:
Voorbeeld 1:
-
Content.title: NULL
-
Description: NULL
-
Type.text: SEH Huisartsenbrief → dit wordt de documentnaam
-
Type.coding.display (niet-LOINC): SEH Huisartsenbrief
-
Type.coding (LOINC): Healthcare communication document
Voorbeeld 2:
-
Content.title: Certe: volledig 24-uurs rr onderzoek → dit wordt de documentnaam
-
Description: Certe: volledig 24-uurs rr onderzoek
-
Type.text: General correspondence
-
Type.coding.display (niet-LOINC): NULL
-
Type.coding (LOINC): General correspondence