Specificatie van de wens (KA-144)

Korte specificatie van de wens

Voor het delen van de resultaten van een vragenlijst of andere vorm van digitale interventie is een user story uitgewerkt gericht op de zorgverlener. Naast dit directe belang voor de zorgverlener is het denkbaar dat de patiënt of cliënt er ook een belang in heeft dat deze type gegevens gedeeld kunnen worden.

	User story

	User story
Wie, Wat, Waarom	Als zorgverlener wil ik alle ruwe data van een ingevulde vragenlijst kunnen delen met andere applicaties zodat ik deze daar kan hergebruiken voor primaire en/of secundaire doeleinden.

Voorbeeld workflow met nieuwe functionaliteit

Applicaties

Welke typen applicaties worden er voor het leveren van digitale zorg gebruikt. Binnen deze use case doen we de aanname dat ieder genoemde applicatie een opzichzelfstaande is. Je kunt hier ook denken in applicatierollen.

Applicatie type	Naam

Applicatie type	Naam
Zorgverlener portaal	Zorgverlener portaal
Patiëntenportaal	Patiëntenportaal
ECD	ECD
e-health platform	e-health platform
e-health module (interventie)	e-health module (interventie)

Vanuit welke applicaties worden de volgende administratieve gegevens gedeeld met de andere applicaties

Brongegevens	Applicatienaam

Brongegevens	Applicatienaam
Patiënt administratieve gegevens	ECD
Zorgverlener gegevens	ECD
Organisatie gegevens	ECD
Zorgteam gegevens	ECD

Digitale zorg workflow

Hoe verloopt de generieke Koppeltaal workflow.

Koppeltaal workflow - nu

Koppeltaal worfklow - gewenst

Beschrijving van de worfkflow

Stappen	Toelichting	Opmerking

Stappen	Toelichting	Opmerking
Start zorgverlener	De zorgverlener is ingelogd in de applicatie waarin de interventies beschikbaar zijn.	In dit voorbeeld is dat het zorgverlener portaal maar dat kan ook ieder andere applicatie zijn zoals bijvoorbeeld het ECD of het e-health platform.
Kiezen interventie	De zorgverlener kiest een geschikte interventie die als onderdeel van het blended zorgproces voor de patiënt.	De digitale interventie is om dit mogelijk te maken gedeeld via Koppeltaal.
Toewijzen interventie	De zorgverlener wijst de interventie toe aan de patiënt.
Start patiënt	De patiënt is ingelogd in de applicatie waar de toegewezen interventie zichtbaar is.	In dit voorbeeld is dat het patiëntenportaal. Vaak is zo’n portaal onderdeel van het ECD of van het e-health platform.
Openen interventie	Wanneer de interventie onderdeel is van de applicatie waarin de patiënt is ingelogd kan deze gestart worden zonder tussenkomst van Koppeltaal. Wanneer de interventie een andere applicatie is wordt deze gestart via de Koppeltaal SSO Launch.	In dit voorbeeld gaan we uit van het openen via de Koppeltaal launch. Het patiëntenportaal en de digitale interventie (module) zijn dus twee losse applicaties.
Uitvoeren interventie	De patiënt kan de interventie nu uitvoeren.	Tijdens het uitvoeren worden er statusupdates over de voortgang gedeeld via Koppeltaal.
Afronden interventie	De patiënt rondt de uitvoering van de interventie af.	Tijdens het afronden wordt een statusupdate gedeeld via Koppeltaal.
Volgen uitvoeren interventie	De zorgverlener kan de status voortgang van het uitvoeren van de interventie volgen door middel van status updates. Zo kan de zorgverlener bijvoorbeeld zien of een interventie gestart is, in uitvoering is, of is afgerond.	In dit voorbeeld gaan we er van uit dat de zorgverlener het verloop kan volgen via het zorgverlener portaal.
Inzien resultaten interventie via Launch.	Wanneer de zorgverlener ziet dat de interventie is afgerond kunnen de resultaten ingezien worden via de Koppeltaal SSO Launch.	De zorgverlener heeft in dit voorbeeld om vanuit het zorgverlener portaal de digitale interventie (module) te openen via de Koppeltaal launch. Er worden hierbij géén resultaatgegevens gedeeld via Koppeltaal.
Delen ruwe gegevens resultaat NIEUWE use case		De e-health module deelt de gestructurerde gegevens van de digitale interventie via Koppeltaal. Omdat de gegevens nu gedeeld zijn via Koppeltaal kunnen andere applicaties hergebruik maken van deze gegevens. Een ECD kan deze gegevens bijvoorbeeld toevoegen aan het dossier van de cliënt/patiënt. (Er zijn wellicht ook relevantie use cases voor secundair gebruik van deze gegevens.) De zorgverlener kan de gegevens direct raadplegen via het ECD.
Stop	De gehele Koppeltaal flow is doorlopen. Indien gewenst kan de flow opnieuw doorlopen worden met een volgende interventie.

Voorbeelden ruwe gegevens.

DTOResult – 1:n.
Hier wordt het resultaat van de test in een of meer schalen teruggeven.
Schaal, SchaalId en Score zijn essentieel.
Bij een subschaal is hasindent true, dit is waarschijnlijk niet relevant voor koppeltaal.

DtoMeting- 0:n
In de praktijk wordt dit altijd gevraagd door klanten bij vragenlijsten. Een meting bevat 1 of meer items DtoItem
DtoItem
ItemNr: volgenummer. Belangrijk omdat niet altijd alle items aanwezig zijn
itemAnswer/ItemScore: soms wordt het daadwerkelijke antwoord gevraagd, soms de score. 

[DtoMetingResultaat{
description:	De schalen en optioneel de items van deze sessie
dtoId	string
nullable: true
De ID van deze meting
datum	string($date-time)
"2018-10-14T11:41:11.740Z", de datum van de eerste inlog
instrument	string
nullable: true
de id van de test
clientLabel	string
nullable: true
het herkenningslabel van de cliënt
status	integer($int32)
0 = klaar, 1=niet af, 2= privacy verklaring (geen levering), 3 = verwijderd
privacyBezwaar	boolean
alleen bij ROM meting, als gevraagd is de gegevens niet te leveren aan AKWA
klaar	boolean
Test is compleet ingevuld
resultaten	[
nullable: true
Lijst van schalen en scores, zie DtoResultaat
DtoResultaat{
description:	Een schaal resultaat
schaal	string
nullable: true
De naam van de schaal
schaalId	string
nullable: true
Een korte unieke id van de schaal
score	string
nullable: true
De score van de schaal Afhankelijk van de vragenlijst een integer of een decimaal
norm	string
nullable: true
Indien beschikbaar, de norm van de schaal
normGroep	string
nullable: true
De naam van de normgroep waarmee de normering is gedaan
hasIndent	boolean
Voor de presentatie van de normen. Als true laat deze schaal inspringen (subschaal)
}]
getItems	boolean
true als om items is gevraagd
meting	DtoMeting{
description:	de items van een meting/vragenlijst
aardMetingCode	integer($int32)
De aardmetingcode zoals gekozen voor deze meting
items	[
nullable: true
De items zoals ingevuld door de client
DtoItem{
description:	Een door de client ingevuld item
itemNr	integer($int32)
het nummer van het item
itemAnswer	string
nullable: true
Het gegeven antwoord (een nummer of tekst, afhankelijk van de vraag)
itemScore	integer($int32)
De vragenlijst score van dit item
}]
}
}]

Voorbeeld 1 (imaginaire client), vragenlijst 4DKL
[
    {
        "dtoId": "3w1a",
        "datum": "2022-09-27T13:35:10.67Z",
        "instrument": "4DKL",
        "clientLabel": "Piet Bruin",
        "status": 0,
        "privacyBezwaar": false,
        "klaar": true,
        "resultaten": [
            {
                "schaal": "Distress",
                "schaalId": "DSTRS",
                "score": "16",
                "norm": "Matig verhoogd",
                "normGroep": "Interpretatie T",
                "hasIndent": false
            },
            {
                "schaal": "Depressie",
                "schaalId": "DEPRS",
                "score": "6",
                "norm": "Sterk verhoogd",
                "normGroep": "Interpretatie T",
                "hasIndent": false
            },
            {
                "schaal": "Angst",
                "schaalId": "ANGST",
                "score": "13",
                "norm": "Sterk verhoogd",
                "normGroep": "Interpretatie T",
                "hasIndent": false
            },
            {
                "schaal": "Somatisatie",
                "schaalId": "SOMAT",
                "score": "16",
                "norm": "Matig verhoogd",
                "normGroep": "Interpretatie T",
                "hasIndent": false
            }
        ],
        "getItems": true,
        "meting": {
            "aardMetingCode": 0,
            "items": [
                {
                    "itemNr": 1,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 2,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 3,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 4,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 5,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 6,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 7,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 8,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 9,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 10,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 11,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 12,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 13,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 14,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 15,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 16,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 17,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 18,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 19,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 20,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 21,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 22,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 23,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 24,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 25,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 26,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 27,
                    "itemAnswer": "5",
                    "itemScore": 2
                },
                {
                    "itemNr": 28,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 29,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 30,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 31,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 32,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 33,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 34,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 35,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 36,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 37,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 38,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 39,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 40,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 41,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 42,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 43,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 44,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 45,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 46,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 47,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 48,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 49,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 50,
                    "itemAnswer": "2",
                    "itemScore": 1
                }
            ]
        }
    }
]

Voorbeeld 2 Imaginaire client, HoNOS+
[
    {
        "dtoId": "za3e",
        "datum": "2022-06-17T12:56:08.677Z",
        "instrument": "HoNOS+V",
        "clientLabel": "2bb0e58e-df26-4f95-a9c5-8870f010c860",
        "status": 0,
        "privacyBezwaar": false,
        "klaar": true,
        "resultaten": [
            {
                "schaal": "ZVT00 Niet te clusteren zorgvraag",
                "schaalId": "ZVT00",
                "score": "0",
                "norm": "",
                "normGroep": null,
                "hasIndent": false
            },
            {
                "schaal": "ZVT01 Psychische aandoening - lichte problematiek",
                "schaalId": "ZVT01",
                "score": "0",
                "norm": "",
                "normGroep": null,
                "hasIndent": false
            },
            {
                "schaal": "ZVT02 Psychische aandoening - lichte problematiek met grotere zorgvraag",
                "schaalId": "ZVT02",
                "score": "0",
                "norm": "",
                "normGroep": null,
                "hasIndent": false
            },
            {
                "schaal": "ZVT03 Psychische aandoening - matige problematiek",
                "schaalId": "ZVT03",
                "score": "7.82457223805206",
                "norm": "2",
                "normGroep": null,
                "hasIndent": false
            },
            {
                "schaal": "ZVT04 Psychische aandoening - ernstige problematiek",
                "schaalId": "ZVT04",
                "score": "0",
                "norm": "",
                "normGroep": null,
                "hasIndent": false
            },
            {
                "schaal": "ZVT05 Psychische aandoening - zeer ernstige problematiek",
                "schaalId": "ZVT05",
                "score": "0",
                "norm": "",
                "normGroep": null,
                "hasIndent": false
            },
            {
                "schaal": "ZVT06 Psychische aandoening - sterk onredelijke overtuiging",
                "schaalId": "ZVT06",
                "score": "0",
                "norm": "",
                "normGroep": null,
                "hasIndent": false
            },
            {
                "schaal": "ZVT07 Psychische aandoening - aanhoudend en/of zeer beperkend",
                "schaalId": "ZVT07",
                "score": "92.1754277619479",
                "norm": "1",
                "normGroep": null,
                "hasIndent": false
            },
            {
                "schaal": "ZVT08 Psychische aandoening - zeer risicovol/chaotische problematiek",
                "schaalId": "ZVT08",
                "score": "0",
                "norm": "",
                "normGroep": null,
                "hasIndent": false
            },
            {
                "schaal": "ZVT10 Psychische stoornis - eerste episode",
                "schaalId": "ZVT10",
                "score": "0",
                "norm": "",
                "normGroep": null,
                "hasIndent": false
            },
            {
                "schaal": "ZVT11 Psychische stoornis - stabiel",
                "schaalId": "ZVT11",
                "score": "0",
                "norm": "",
                "normGroep": null,
                "hasIndent": false
            },
            {
                "schaal": "ZVT12 Psychische stoornis - chronisch en beperkend",
                "schaalId": "ZVT12",
                "score": "0",
                "norm": "",
                "normGroep": null,
                "hasIndent": false
            },
            {
                "schaal": "ZVT13 Psychische stoornis - beperkend met ernstige psychotische kenmerken",
                "schaalId": "ZVT13",
                "score": "0",
                "norm": "",
                "normGroep": null,
                "hasIndent": false
            },
            {
                "schaal": "ZVT14 Psychische stoornis - acute episode",
                "schaalId": "ZVT14",
                "score": "0",
                "norm": "",
                "normGroep": null,
                "hasIndent": false
            },
            {
                "schaal": "ZVT15 Depressie met psychotische kenmerken - acute episode",
                "schaalId": "ZVT15",
                "score": "0",
                "norm": "",
                "normGroep": null,
                "hasIndent": false
            },
            {
                "schaal": "ZVT16 Psychische stoornis - chronisch, instabiel en ernstig middelengebruik",
                "schaalId": "ZVT16",
                "score": "0",
                "norm": "",
                "normGroep": null,
                "hasIndent": false
            },
            {
                "schaal": "ZVT17 Psychische stoornis - chronisch, instabiel en zeer lage motivatie/therapietrouw",
                "schaalId": "ZVT17",
                "score": "0",
                "norm": "",
                "normGroep": null,
                "hasIndent": false
            },
            {
                "schaal": "ZVT18 Cognitieve beperking - licht",
                "schaalId": "ZVT18",
                "score": "0",
                "norm": "",
                "normGroep": null,
                "hasIndent": false
            },
            {
                "schaal": "ZVT19 Cognitieve beperking - matig / lichte gedrags- of psychische complicaties",
                "schaalId": "ZVT19",
                "score": "0",
                "norm": "",
                "normGroep": null,
                "hasIndent": false
            },
            {
                "schaal": "ZVT20 Cognitieve beperking - ernstig met matige gedrags- of psychische complicaties",
                "schaalId": "ZVT20",
                "score": "0",
                "norm": "",
                "normGroep": null,
                "hasIndent": false
            },
            {
                "schaal": "ZVT21 Cognitieve beperking - ernstig met ernstige gedrags- of psychische complicaties",
                "schaalId": "ZVT21",
                "score": "0",
                "norm": "",
                "normGroep": null,
                "hasIndent": false
            }
        ],
        "getItems": true,
        "meting": {
            "aardMetingCode": 0,
            "items": [
                {
                    "itemNr": 1,
                    "itemAnswer": "1",
                    "itemScore": 0
                },
                {
                    "itemNr": 2,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 3,
                    "itemAnswer": "3",
                    "itemScore": 2
                },
                {
                    "itemNr": 4,
                    "itemAnswer": "4",
                    "itemScore": 3
                },
                {
                    "itemNr": 5,
                    "itemAnswer": "5",
                    "itemScore": 4
                },
                {
                    "itemNr": 6,
                    "itemAnswer": "1",
                    "itemScore": 0
                },
                {
                    "itemNr": 7,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 8,
                    "itemAnswer": "3",
                    "itemScore": 2
                },
                {
                    "itemNr": 9,
                    "itemAnswer": "4",
                    "itemScore": 3
                },
                {
                    "itemNr": 10,
                    "itemAnswer": "5",
                    "itemScore": 4
                },
                {
                    "itemNr": 11,
                    "itemAnswer": "1",
                    "itemScore": 0
                },
                {
                    "itemNr": 12,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 13,
                    "itemAnswer": "3",
                    "itemScore": 2
                },
                {
                    "itemNr": 14,
                    "itemAnswer": "4",
                    "itemScore": 3
                },
                {
                    "itemNr": 15,
                    "itemAnswer": "5",
                    "itemScore": 4
                },
                {
                    "itemNr": 16,
                    "itemAnswer": "1",
                    "itemScore": 0
                },
                {
                    "itemNr": 17,
                    "itemAnswer": "2",
                    "itemScore": 1
                },
                {
                    "itemNr": 18,
                    "itemAnswer": "3",
                    "itemScore": 2
                },
                {
                    "itemNr": 19,
                    "itemAnswer": "4",
                    "itemScore": 3
                },
                {
                    "itemNr": 20,
                    "itemAnswer": "1",
                    "itemScore": 1
                }
            ]
        }
    }
]

Veldnaam	Omschrijving	Type	Voorbeeld	Opties

Veldnaam	Omschrijving	Type	Voorbeeld	Opties
e-mail	het e-mailadres van de gebruiker van de app.	tekst	gebruiker@yahoo.com	alle e-mailadressen mogelijk
results_answers_questionStressLevelScore	het berekende stressniveau o.b.v. een ingevulde vragenlijst	tekst	SOME_STRESS	NO_STRESS, SOME_STRESS, NORMAL_STRESS, STRESS of MUCH_STRESS
results__createdAt	datum+tijd waarop de gebruiker de vragenlijst heeft ingevuld	datum+tijd	13-5-2023 08:00