3.8 Terugkeren naar PGO

DVP kan er voor kiezen in de launch-context een terugkeeradres mee te geven. De module biedt de gebruiker dan na het afsluiten van de applicatie aan om terug te keren naar het PGO. Het terugkeeradres komt mee in 3.5 Starten aanbiedermodule | 3.-Uitwisselen-launch-context als return_url=https://pgo.example.org/launch_callback.

Met de return_url worden ook de mobiele apps afgevangen. Voor iOS heet dit Universal Links en voor Android heet dit App Links. Dit is de verantwoordelijkheid van de app-bouwers.

Processtappen

Processtap

Toelichting

1. Persoon eindigt gebruik module

Persoon kiest er voor om aanbiedermodule af te sluiten met een menu-optie. Bijvoorbeeld omdat deze de aanbiedermodule niet wil gebruiken of omdat het werk in de module is afgerond.

2. Browser keert terug

Aanbiedermodule gebruikt het gegeven launch-context in 4.2 om de waarde return_url uit te lezen. Er bestaat geen vaste whitelist om de waarde van de parameter tegen te verifiëren.

Uitwerking volgt: In MedMij Afsprakenstelsel heeft DVA de mogelijkheid om PGO te valideren tegen Stelselnode-whitelist. In Koppeltaal heeft aanbiedermodule-applicatie de mogelijkheid om patiëntportaal te valideren tegen whitelist.

Uitwerking volgt: Foutafhandeling kan de bekende OAuth2 error en error_description -query-parameters volgen zodat de DVP aanvullende schermen kan tonen om opnieuw module te bezoeken.

Procesdiagram

Procesdialoog

Browser van de gebruiker keert terug naar PGO op de return_url. Optioneel wordt een foutcode meegegeven als de gebruiker annuleerde of geen toegang kreeg.

JSON

6.2 Persoon keert terug

HTTP 302 Redirect
GET https://pgo.example.org/launch_callback

JSON

6.3 Persoon keert terug na afbreken

HTTP 302 Redirect
GET https://pgo.example.org/launch_callback?error=temporarily_unavailable

Bijwerken van taakstatus vóór terugkeer naar het PGO

Voordat de module de gebruiker terugstuurt naar het PGO via de return_url, MOET de moduleleverancier de status van de taak bijwerken naar de juiste FHIR Task.status.
De status weerspiegelt de uitkomst van het gebruik van de aanbiedermodule (bijv. accepted, rejected, in-progress, completed, failed of cancelled).

Dit is essentieel omdat het PGO na de redirect opnieuw een GET-request kan uitvoeren om de meest recente taakstatus op te halen.
Zo blijft de taakweergave in het PGO synchroon met de werkelijkheid en wordt inconsistentie tussen module en PGO voorkomen.

De module:

werkt de relevante Task.resource bij via de DVA-FHIR-endpoint, conform MedMij-functie Verzamelen;
pas na succesvolle status-update stuurt de module de gebruiker terug naar het PGO via HTTP 302 naar de return_url.

Het PGO:

ontvangt de gebruiker op de return_url;
haalt vervolgens (optioneel direct) de taak opnieuw op via de reguliere FHIR GET;
toont de bijgewerkte status en eventuele aanvullende foutcodes of metadata.