Brontekst bekijken van MedMij:V2020.01/OntwerpVragenlijsten

__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vragenlijsten {{VersieInfo|Vragenlijsten}}}}
{{MedMij:V2020.01/Issuebox}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:Vragenlijsten-zonder-tekst-dun.png|link=|87px |links||media|Vragenlijsten]]
<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.01/Ontwerpen|Functioneel]]                
circle 1787 230 212 [[MedMij:V2020.01/FHIR_Questionnaire_and_Questionnaire_Response_(Vragenlijsten)|Technisch]]                
desc none                    
</imagemap>


=Inleiding= 
==Algemeen==
Op deze pagina wordt het functioneel ontwerp beschreven voor de uitwisseling van vragenlijsten en antwoorden binnen MedMij. De algemene inleiding van de MedMij functionele ontwerpen kan gevonden worden op de pagina  [[MedMij:V2020.01/Ontwerpen|Ontwerpen MedMij]]. 

Het ontwerp richt zich op de uitwisseling van informatie en niet op de gebruikersfunctionaliteiten en/of gebruiksvriendelijkheid van een PGO of het systeem van de zorgaanbieder (XIS). 

Voor de informatiestandaard Vragenlijsten wordt er naast de inhoudelijke gegevens, ook technische informatie uitgewisseld over de workflow-status. Dit gebeurt door het bijwerken van een taak die wordt uitgezet ("FHIR QuestionnaireProvisioningTask", voor meer informatie zie het [[MedMij:V2020.01/FHIR_Questionnaire_and_Questionnaire_Response_(Vragenlijsten)|technisch ontwerp]]). Voor de toepassing van deze informatie binnen MedMij kan deze taak onafhankelijk van de gegevensdienst(en) uitgevoerd worden. Wel kan aangenomen worden dat bepaalde statuswijzigingen vaker binnen een bepaalde gegevensdienst plaatsvinden. Bijvoorbeeld: bijwerken naar “voltooid (completed)” past bij het opsturen van de vragenlijstantwoorden. 

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

==Kaders en uitgangspunten==
===Richtlijn===
Conform specificaties genoemd in [[MedMij:V2020.01/Ontwerpen#Richtlijn| de algemene inleiding]] van de MedMij functionele ontwerpen.

Toelichting op de zorginformatiebouwstenen: Vragenlijsten versie {{VersieInfo|Vragenlijsten}} maakt gebruik van [https://zibs.nl/wiki/ZIB_Publicatie_2017(NL) zib publicatie 2017].

Er zijn geen richtlijnen van het zorgaanbiedersdomein. Bij implementeren van de standaard gelden de volgende uitgangspunten:
* Maak gebruik van de bestaande, internationale, FHIR-profielen van [http://hl7.org/fhir/us/sdc/index.html SDC (Structured Data Capture)]
** Bij het overnemen van een profiel, zijn deze in hun geheel toegepast
** Het gaat alleen om die profielen die voor deze use case toegevoegde waarde hebben
* Bij ieder overgenomen profiel is, een voor Nederland specifiek profiel opstellen. Er is bijvoorbeeld minimaal een referentie nodig naar het Nederlandse patiëntprofiel
* De SDC-profielen hebben reeds veel verschillende vraagsoorten & antwoordmogelijkheden gespecificeerd, deze worden overgenomen.

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

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

===Informatie reikwijdte===
Het ontwerp richt zich op de uitwisseling van informatie en niet op de gebruikersfunctionaliteiten en/of gebruiksvriendelijkheid van een PGO of het systeem van de zorgaanbieder (XIS).  
Het ontwerp bevat:
* Een eenvoudige zorgsituatie:

# Een zorgaanbieder maakt, buiten de persoonlijke gezondheidsomgeving om, een afspraak met een patiënt over het invullen van een vragenlijst
# Deze zorgaanbieder maakt de vragenlijst beschikbaar voor de persoonlijke gezondheidsomgeving van de patiënt
# De patiënt gebruikt zijn persoonlijke gezondheidsomgeving om de vragenlijst op te halen
# De patiënt vult de vragenlijst in en stuurt de antwoorden in zijn geheel terug naar het systeem van de zorgaanbieder (XIS).

Expliciet buiten scope van het ontwerp zijn de volgende onderwerpen:
* Workflow-gerelateerde zaken.
** Notificaties, anders dan waarin het afsprakenstelsel van MedMij wordt voorzien.
** Werkafspraken over (tijdigheid van) invullen en terug sturen.
** Aanpak voor multi-channel mogelijkheden (bijvoorbeeld: via PGO in combinatie met portaal en schriftelijk).

* Complexe computergestuurde vragenlijsten (bijvoorbeeld: Computer Adaptive Testing - CAT).
* Interpretatie van antwoorden. Een uitgangspunt is om PGO's nog niet te belasten met het berekenen van scores op basis van ingevulde antwoorden. Het uitwisselen van de definitie van score-berekening is daarom ook buiten scope. Een XIS kan eventueel berekende scores en terugsturen aan een PGO met de use case [[MedMij:V2020.01/OntwerpPDFA#Use_case:_Raadplegen_medische_gegevens_in_PDF.2FA_door_pati.C3.ABnt|PDF/A]].  
* Ontwikkeling van nieuwe zibs specifiek voor vragenlijsten.
* Standaardisatie van de inhoud van vragenlijsten (de deliverables van dit project zijn content-agnostisch).
* Toepassing van specifieke coderingen of codestelsels (met uitzondering van administratieve gegevens van patiënt).
* Mogelijke financiële consequenties van het gebruik van vragenlijsten, bijvoorbeeld licentiekosten.

'''Nb.''' Vragenlijsten kunnen gespecificeerde opmaak (bijvoorbeeld vet- of schuingedrukte tekst) hebben die betekenisvol is voor het invullen van een vragenlijst door een PGO-Gebruiker en hiermee relevant is voor een zorgverlener om de uitkomsten te interpreteren. De standaard voorziet in de mogelijkheden om opmaak te specificeren en van gebruikers van deze standaard wordt verwacht dat ze hiermee om kunnen gaan.

==Kwalificatie==
===Introductie===
{{#lst:MedMij:V2020.01/Ontwerpen|medmij_kwalificatie_introductie}}

=Use Cases=
Het raadplegen van de vragenlijstverwijzing, vragenlijst en het sturen van de antwoorden zijn 3 use cases die nadrukkelijk bij elkaar horen. Functioneel kunnen ze zelfs gezien worden als verschillende acties binnen een zelfde use case. Ze zijn echter als separate use case gedefinieerd omdat:
* Het raadplegen van een verwijzing naar een vragenlijst, de vragenlijst en het sturen van de antwoorden asynchroon plaatsvindt
* Het MedMij-afsprakenstelsel voor 'raadplegen en beschikbaarstellen' en voor 'sturen en ontvangen' separate use cases definieert. 
Door dit ook in de informatiestandaard gescheiden te houden, kunnen de use cases uit de informatiestandaard goed gemapt worden op de use cases uit het [https://afsprakenstelsel.medmij.nl/display/MedMijAfsprakenstelsel120/MedMij+Afsprakenstelsel+1.2.0 MedMij-afsprakenstelsel]. De splitsing is alleen niet goed voor het totaaloverzicht van de verschillende scenario's. 

Er zijn twee bedrijfsrollen, namelijk ''Patiënt'' en ''Zorgaanbieder''. Een zorgaanbieder biedt een verwijzing naar een vragenlijst aan, die gebruikt kan worden door een patiënt om bij de zorgaanbieder zelf of een externe repository een vragenlijst op te halen. De patiënt kan dan de vragenlijst invullen en terugsturen naar de zorgaanbieder. Onderstaande tabel geeft de rollen weer.

{| 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 vragenlijsten in een persoonlijke gezondheidsomgeving kunnen invullen en de antwoorden terugsturen. 
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Wil dat patiënten vragenlijsten invullen en de antwoorden aan de zorgaanbieder sturen. 
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd in samenhang met de beschreven use cases.

[[Image:Activity_Diagram_-_Vragenlijsten.png|Activiteitendiagram vragenlijsten]]

<font size = "1">'''Activiteitendiagram vragenlijsten'''</font>

==Use case: Raadplegen vragenlijstverwijzing ==
=== Doel en relevantie ===
Het voor patiënten mogelijk maken om in een PGO een vragenlijst te ontvangen en in te vullen.
=== Domein ===
Vragenlijsten in het domein van zorgaanbieders en patiënten.

=== Context ===
Het gaat om het elektronisch en gestructureerd aanbieden c.q. beschikbaarstellen van vragenlijsten door zorgaanbieders vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ 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.

=== Informatie === 
De informatie-elementen voor raadplegen en beschikbaarstellen vragenlijstverwijzing staan in [https://decor.nictiz.nl/pub/vragenlijsten/ ART-DECOR]

==== Raadplegen vragenlijstverwijzing ====
Er zijn geen specifieke filtermogelijkheden (query parameters) gedefinieerd voor de raadplegen vragenlijstverwijzing. 

==== Beschikbaarstellen vragenlijstverwijzing ====
Informatie-elementen in Vragenlijsten staan hieronder. Deze informatie is ook in een nieuw tabblad te openen.

<html>
<iframe width="100%" height="400" src=https://decor.nictiz.nl/pub/vragenlijsten/vl-html-20210318T181429/tr-2.16.840.1.113883.2.4.3.11.60.56.4.256-2020-02-02T215945.html frameborder="0" align="middle"></iframe>
</html>

=== Bedrijfsrollen ===
Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd in samenhang met de beschreven use cases.

[[Image:Activity_Diagram_-_Vragenlijsten.png|Activiteitendiagram vragenlijsten]]

=== Procesbeschrijving ===
==== Patient Journey – Jelmer Postma ==== 
Een voorbeeldsituatie die de meerwaarde van vragenlijsten met een PGO schetst is de patient journey van [[Media:Casus_Jelmer_Postma_MedMij_20210429.pdf|Jelmer Postma]].  
<blockquote>De psycholoog belt Jelmer voor de afspraak en vraagt of hij een vragenlijst wil beantwoorden. De vragen gaan over zijn klachten en hoe hij dagelijkse activiteiten en het contact met vrienden en familie ervaart. Jelmer spreekt met hem af om voor zijn eerste afspraak de vragen in te vullen. De psycholoog heeft een link naar de vragenlijst voor hem klaar gezet. Jelmer kan met zijn PGO de link ophalen zodat hij de vragenlijst kan openen.</blockquote>

==== Proces ====
Deze use case ondersteunt geen workflow tussen zorgaanbieder en patiënt. Eventuele procesafspraken zijn dus geen onderdeel van deze use case. Voordat het proces start heeft een medewerker van de zorgaanbieder met een patiënt afgesproken om op of voor een bepaald moment een vragenlijst in te vullen. Het stuk van het proces waar het in deze use case om gaat is:
* Een zorgaanbieder (XIS) stelt de vragenlijstverwijzing beschikbaar. 
Het resultaat is dat de patiënt (PGO) de beschikking over een verwijzing waarmee die vervolgens de relevante vragenlijst kan ophalen. 

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

===== Preconditie ===== 
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van vragenlijsten tussen zijn PGO en het betreffende XIS. 
De patiënt en zorgaanbieder hebben onderling procesafspraken gemaakt over het invullen van de vragenlijst.
Het XIS van de zorgaanbieder is in staat vragenlijstverwijzingen specifiek beschikbaar te stellen aan een patiënt en vervolgens de antwoorden weer te ontvangen van de patiënt via zijn PGO.
De XIS is in staat de betreffende vragenlijst beschikbaar te stellen aan raadplegers.

===== Processtappen ===== 
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Stap
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| 01
| style="background-color: white;"| Zorgaanbieder wijst een bepaalde vragenlijst toe aan patiënt (in het XIS)
|-
| style="background-color: white;"| 02
| style="background-color: white;"| PGO bevraagt het XIS om deze toewijzing te ontvangen in de vorm van een verwijzing naar een vragenlijst. Deze verwijzing is een URI waar het PGO de daadwerkelijke vragenlijst kan ophalen.
|}

===== Postconditie ===== 
Patiënt heeft de beschikking over de vragenlijst in zijn PGO en kan de vragen daar gaan invullen.

=== Systemen & Systeemrollen ===
Zowel de patiënt 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 vragenlijsten en antwoorden tussen de persoon en de zorgaanbieder. 

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| Vragenlijstverwijzing raadplegend systeem
| style="background-color: white;"| VL-{{VersieInfo|Vragenlijsten}}-QLR-FHIR
| style="background-color: white;"| Raadplegen van verwijzing naar vragenlijst door patiënt
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Vragenlijstverwijzing beschikbaarstellend systeem
| style="background-color: white;"| VL-{{VersieInfo|Vragenlijsten}}-QLB-FHIR
| style="background-color: white;"| Beschikbaarstellen van verwijzing naar vragenlijst voor PGO
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vragenlijsten_(Raadplegen).png|Componenten diagram Vragenlijstverwijzing en Vragenlijst raadplegen]]

<font size = "1">'''Componenten diagram Vragenlijsten raadplegen'''</font>

De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

=== 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;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:middle;" rowspan="2"|Verwijzing naar vragenlijsten(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen verwijzing naar vragenlijst
| style="background-color: white;"| VL-{{VersieInfo|Vragenlijsten}}-QLR-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:V2020.01/FHIR_Questionnaire_and_Questionnaire_Response_(Vragenlijsten)|Questionnaire(response) in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen verwijzing naar vragenlijst
| style="background-color: white;"| VL-{{VersieInfo|Vragenlijsten}}-QLB-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_-_Vragenlijsten_(Raadplegen).png|Use case diagram Sturen Beelden]]

<font size = "1">'''Use case diagram raadplegen vragenlijstverwijzing en raadplegen vragenlijst</font>

==Use case: Raadplegen vragenlijst ==
{{NoteBox|1= Deze uitwisseling kan op dit moment niet via het MedMij Afsprakenstelsel / het MedMij-netwerk plaatsvinden.}}
=== Doel en relevantie ===
Het voor patiënten mogelijk maken om in een PGO een vragenlijst te ontvangen en in te vullen. Het vervolgens weer terugsturen van de antwoorden staat beschreven in een aparte use case: [[MedMij:V2020.01/OntwerpVragenlijsten#Use_case:_Sturen_vragenlijstantwoorden|sturen vragenlijstantwoorden]].

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

=== Context ===
Het gaat om het elektronisch en gestructureerd aanbieden c.q. beschikbaarstellen van vragenlijsten door zorgaanbieders vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ 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.

=== Informatie === 
De informatie-elementen voor raadplegen en beschikbaarstellen vragenlijst staan in [https://decor.nictiz.nl/pub/vragenlijsten/ ART-DECOR]

Deze informatie-elementen ondersteunen de volgende aspecten:
* Het al dan niet tonen van bepaalde vragen in de vragenlijst afhankelijk van de antwoorden:
** Hierbij gaat het er om dat sommige vragen overgeslagen worden op basis van een antwoord op een andere vraag (sprongvragen). De dataset kent hiervoor het element 'enableWhen'
* Specificeren van verschillende type vragen:
** Het gaat dan om bijvoorbeeld keuzelijst met één of meerdere selecties, vrije tekst, combinaties hiervan, schalen, et cetera
* Vragenlijsten kunnen ook bepaalde eisen aan de weergave van vragen/antwoordopties definiëren, welke dan verplicht zijn om te volgen. Het verschillend weergegeven van vragenlijsten compromitteren de validiteit en/of vergelijkbaarheid van de vragenlijst. Denk hierbij aan:
** volgorde van antwoordopties of 
** het in één keer tonen van alle antwoordopties of 
** het recht onder elkaar staan van antwoordopties
** specifieke opmaak zoals '''vet'''- of ''schuin''gedrukte tekst

==== Raadplegen vragenlijst ====
Er zijn geen specifieke filtermogelijkheden (query parameters) gedefinieerd voor de raadplegen vragenlijst. 

==== Beschikbaarstellen vragenlijst ====
Informatie-elementen in Vragenlijsten staan hieronder. Deze informatie is ook in een nieuw tabblad te openen.

<html>
<iframe width="100%" height="400" src=https://decor.nictiz.nl/pub/vragenlijsten/vl-html-20210318T181429/tr-2.16.840.1.113883.2.4.3.11.60.56.4.255-2019-04-11T140121.html frameborder="0" align="middle"></iframe>
</html>

=== Bedrijfsrollen ===
Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd in samenhang met de beschreven use cases.

[[Image:Activity_Diagram_-_Vragenlijsten.png|Activiteitendiagram vragenlijsten]]

=== Procesbeschrijving ===
==== Patient Journey – Jelmer Postma ==== 
Een voorbeeldsituatie die de meerwaarde van vragenlijsten met een PGO schetst is de patient journey van [[Media:Casus_Jelmer_Postma_MedMij_20210429.pdf|Jelmer Postma]].  
<blockquote>Jelmer kan met zijn PGO de link ophalen zodat hij de vragenlijst kan openen.</blockquote>

==== Proces ====
Deze use case ondersteunt geen workflow tussen zorgaanbieder en patiënt. Eventuele procesafspraken zijn dus geen onderdeel van deze use case. 
Voordat het proces start heeft een medewerker van de zorgaanbieder met een patiënt afgesproken om op of voor een bepaald moment een vragenlijst in te vullen. 

Het stuk van het proces waar het in deze use case om gaat is:
* Een zorgaanbieder stelt de vragenlijst beschikbaar (bijvoorbeeld via een vragenlijst-repository waarbij het niet relevant is of de zorgaanbieder deze repository zelf aanbiedt of gebruik maakt van een externe partij).
* De zorgaanbieder koppelt een vragenlijst aan de patiënt.
* De patiënt haalt vervolgens de relevante vragenlijst op.
Het resultaat is dat de patiënt de beschikking heeft over de vragenlijst in zijn PGO en de vragen kan gaan beantwoorden.

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

===== Preconditie ===== 
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van vragenlijsten tussen zijn PGO en het betreffende XIS. 
De patiënt en zorgaanbieder hebben onderling procesafspraken gemaakt over het invullen van de vragenlijst.
Het XIS van de zorgaanbieder is in staat vragenlijstverwijzingen specifiek beschikbaar te stellen aan een patiënt en vervolgens de antwoorden weer te ontvangen van de patiënt via zijn PGO.
XIS is in staat de betreffende vragenlijst beschikbaar te stellen aan raadplegers.

===== Processtappen ===== 
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Stap
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| 01
| style="background-color: white;"| PGO heeft vanuit het XIS een verwijzing naar een vragenlijst ontvangen. Zie use case [[MedMij:V2020.01/OntwerpVragenlijsten#Use_case:_Raadplegen_vragenlijstverwijzing|Raadplegen vragenlijstverwijzing]]
|-
| style="background-color: white;"| 02
| style="background-color: white;"| PGO haalt vervolgens de vragenlijst op.
|}

===== Postconditie ===== 
Patiënt heeft de beschikking over de vragenlijst in zijn PGO en kan de vragen daar gaan invullen.

=== Systemen & Systeemrollen ===
{{NoteBox|1= Deze uitwisseling kan op dit moment niet via het MedMij Afsprakenstelsel / het MedMij-netwerk plaatsvinden.}}
Zowel de patiënt 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 vragenlijsten en antwoorden tussen de persoon en de zorgaanbieder. 

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| Vragenlijst raadplegend systeem
| style="background-color: white;"| VL-{{VersieInfo|Vragenlijsten1}}-QER-FHIR
| style="background-color: white;"| Raadplegen van vragenlijst door PGO (zonder dat het herleidbaar is op de persoon)
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Vragenlijst beschikbaarstellend systeem
| style="background-color: white;"| VL-{{VersieInfo|Vragenlijsten1}}-QEB-FHIR
| style="background-color: white;"| Beschikbaarstellen van vragenlijst voor PGO  (zonder dat het herleidbaar is op de persoon)
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vragenlijsten_(Raadplegen).png|Componenten diagram Vragenlijstverwijzing en Vragenlijst raadplegen]]

<font size = "1">'''Componenten diagram Vragenlijsten raadplegen'''</font>

De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

=== Transacties & Transactiegroepen ===
{{NoteBox|1= Deze uitwisseling kan op dit moment niet via het MedMij Afsprakenstelsel / het MedMij-netwerk plaatsvinden.}}
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;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:middle;" rowspan="2"|Vragenlijsten(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vragenlijst
|style="background-color: white;vertical-align:top;"|VL-{{VersieInfo|Vragenlijsten1}}-QER-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:V2020.01/FHIR_Questionnaire_and_Questionnaire_Response_(Vragenlijsten)|Questionnaire(response) in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vragenlijst
|style="background-color: white;vertical-align:top;"|VL-{{VersieInfo|Vragenlijsten1}}-QEB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
[[Bestand:Use_Case_Diagram_-_Vragenlijsten_(Raadplegen).png|Use case diagram Sturen Beelden]]

<font size = "1">'''Use case diagram raadplegen vragenlijstverwijzing en raadplegen vragenlijst</font>

==Use case: Sturen vragenlijstantwoorden ==
=== Doel en relevantie ===
Het voor patiënten mogelijk maken om vanuit een PGO de antwoorden op een vragenlijst terug te sturen naar de zorgaanbieder.

=== Domein ===
Antwoorden op vragenlijsten in het domein van zorgaanbieders en patiënten.

=== Context ===
Het gaat om het elektronisch en gestructureerd sturen van antwoorden op vragenlijsten door PGO-gebruiker aan zorgaanbieders vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ 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.

=== Informatie === 
De informatie-elementen voor sturen en ontvangen vragenlijstantwoorden staan in [https://decor.nictiz.nl/pub/vragenlijsten/ ART-DECOR]

Informatie-elementen in Vragenlijstantwoorden staan hieronder. Deze informatie is ook in een nieuw tabblad te openen.

<html>
<iframe width="100%" height="500" src=https://decor.nictiz.nl/pub/vragenlijsten/vl-html-20210318T181429/tr-2.16.840.1.113883.2.4.3.11.60.56.4.263-2020-04-01T135355.html frameborder="0" align="middle"></iframe>
</html>

=== Bedrijfsrollen ===
Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd in samenhang met de hieronder beschreven use cases.

[[Image:Activity_Diagram_-_Vragenlijsten.png|Activiteitendiagram vragenlijsten]]

=== Procesbeschrijving ===
==== Patient Journey – Jelmer Postma ==== 
Een voorbeeldsituatie die de meerwaarde van vragenlijsten met een PGO schetst is de patient journey van [[Media:Casus_Jelmer_Postma_MedMij_20210429.pdf|Jelmer Postma]].  
<blockquote>De ingevulde vragenlijst stuurt hij met zijn PGO op naar de psycholoog.</blockquote>
<blockquote>‘Pling’, Jelmer krijgt van zijn PGO een reminder dat hij morgen om 10.00 zijn eerste afspraak heeft bij de psycholoog. De psycholoog heeft zijn ingevulde vragenlijst ontvangen en neemt samen met Jelmer de antwoorden door.</blockquote>

==== Proces ====
Deze use case ondersteunt geen workflow tussen zorgaanbieder en patiënt. Eventuele procesafspraken zijn dus geen onderdeel van deze use case. 
Voordat het proces start heeft een medewerker van de zorgaanbieder met een patiënt afgesproken om op of voor een bepaald moment een vragenlijst in te vullen. Ook heeft de patiënt de vragenlijst opgehaald zoals beschreven in [[MedMij:V2020.01/OntwerpVragenlijsten#Use_case_1:_Raadplegen_vragenlijst|de use case raadplegen vragenlijst]].

Het stuk van het proces waar het in deze use case om gaat is: 
* De patiënt beantwoordt de vragenlijst in zijn PGO en stuurt de antwoorden terug naar de zorgaanbieder.

Afhankelijk van het doel van de vragenlijst kan een medewerker van de zorgaanbieder de vragenlijst met de patiënt op een later moment bespreken. 

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 (antwoorden op) vragenlijsten tussen zijn PGO en het betreffende XIS. 
De patiënt en zorgaanbieder hebben onderling procesafspraken gemaakt over het invullen van de vragenlijst. Het PGO heeft een vragenlijst opgehaald.

===== Proces stappen ===== 
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Stap
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| 01
| style="background-color: white;"| PGO stelt de patiënt in staat de vragenlijsten in te vullen
|-
| style="background-color: white;"| 02
| style="background-color: white;"| Patiënt beantwoordt de vult de vragenlijsten in
|-
| style="background-color: white;"| 03
| style="background-color: white;"| Patiënt bepaalt wanneer het invullen gereed is
|-
| style="background-color: white;"| 04
| style="background-color: white;"| PGO stuurt de antwoorden terug naar het XIS
|}

===== Postconditie ===== 
De zorgaanbieder kan de vragenlijst met antwoorden inzien in het XIS.
De patiënt en zorgaanbieder kunnen hierover in overleg.

=== Systemen & Systeemrollen ===
Zowel de persoon als de zorgaanbieder maken 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 vragenlijsten en antwoorden tussen de persoon en de zorgaanbieder. 

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| Antwoorden op vragenlijst sturend systeem 
| style="background-color: white;"| VL-{{VersieInfo|Vragenlijsten}}-QRS-FHIR
| style="background-color: white;"| Sturen van antwoorden op de vragenlijst aan zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Antwoorden op vragenlijst ontvangend systeem
| style="background-color: white;"| VL-{{VersieInfo|Vragenlijsten}}-QRO-FHIR
| style="background-color: white;"| Ontvangen van antwoorden op de vragenlijst van de patiënt
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vragenlijsten_(Sturen).png|Componenten diagram Vragenlijstverwijzing en Vragenlijst sturen]]

<font size = "1">'''Componenten diagram Vragenlijsten sturen'''</font>

De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

=== 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;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:middle;" rowspan="2"|Antwoorden op vragenlijst (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen antwoorden op vragenlijst
|style="background-color: white;vertical-align:top;"|VL-{{VersieInfo|Vragenlijsten}}-QRS-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:V2020.01/FHIR_Questionnaire_and_Questionnaire_Response_(Vragenlijsten)|Questionnaire(response) in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Ontvangen antwoorden op vragenlijst
|style="background-color: white;vertical-align:top;"|VL-{{VersieInfo|Vragenlijsten}}-QRO-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 met [[MedMij:V2020.01/OntwerpVragenlijsten#Use_case_1:_Raadplegen_vragenlijst|de use case raadplegen vragenlijsten]].

[[Bestand:Use_Case_Diagram_-_Vragenlijsten_(Sturen).png|Use case diagram Sturen Vragenlijsten]]

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

=Functionaliteit=
Er zijn geen aanwijzingen/eisen voor functionaliteit van de systemen.

=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="sdc">-</span>
| style="background-color: white;"| Structured Data Capture (SDC)
| style="background-color: white;"| 2.0 (STU2)
| style="background-color: white;"| 2017-04-21
| style="background-color: white;"| https://hl7.org/fhir/us/sdc/STU2/
| style="background-color: white;"| U.S. Office of the National Coordinator (ONC)'s Standards and Infrastructure (S & I) Framework
|}
<font size = "1">'''Referenties</font>

=Release notes=

In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.
{{#lsth:Tabellen met release notes|Vragenlijsten 2}}