Skip to main content
Skip table of contents

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

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

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

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

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

  1. De e-health module deelt de gestructurerde gegevens van de digitale interventie via Koppeltaal.

  2. 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.)

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

User story 1a - met twee voorbeelden (4DKL en HoNOS+)
CODE
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
                }
            ]
        }
    }
]
User story 2a - met een voorbeeld van applicatie die stess meet

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

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.