Notify patroon

Het is vaak van belang om op de hoogte te worden gebracht van wijzigingen op specifieke resources. Een applicatieinstantie kan zich eenmalig abonneren op specifieke gebeurtenissen in de FHIR store, zodat ze gesignaleerd worden wanneer de gebeurtenis plaatsvindt. Typische gebeurtenissen waar een applicatieinstantie zich op kunnen abonneren zijn het creëren en wijzigen van gegevens. Afhankelijk van de specifieke toepassing van het notify-patroon kan de applicatieinstantie kiezen om wel of niet te acteren op de ontvangen notificatie. Zie TOP-KT-006 voor meer informatie over abonnementen, gebeurtenissen en signalen,

De onderstaande tabel en het interactiemodel beschrijven het notify-patroon van abonneren en signaleren.

Patroon naam	Notify
Systemen	Applicatieinstantie, FHIR store
Voorwaarde	De applicatieinstantie is geautoriseerd om zich te abonneren op een gebeurtenis. De applicatieinstantie is geautoriseerd om notificaties te ontvangen.
Trigger	Gebeurtenissen die bij de FHIR store plaatsvinden conform het abonnement.
Resultaat	De applicatieinstantie is gesignaleerd dat de gebeurtenis heeft plaatsgevonden bij de FHIR store en alle relevante events zijn gelogd door het verantwoordelijke systeem.
Gerelateerde use cases	KT.UC.002 - Registreren abonnement(en) KT.UC.003b - Volgen administratieve gegevens KT.UC.006 - Volgen status digitale interventie

#	Actie	Omschrijving
1	Abonneren verzoek	De applicatieinstantie initieert het abonneren op een gebeurtenis middels een abonnement verzoek (POST /Subscription) naar de FHIR store.
2	Abonneren reponse	De FHIR store valideert het verzoek tot abonneren en stuurt een geschikte response naar de applicatieinstantie.
3	Gebeurtenis	De FHIR store monitort de resources voor gebeurtenissen, zoals beschreven in het abonnement.
4	Notificatie	Wanneer een gebeurtenis plaatsvindt stuurt de FHIR store een notificatie (POST rest-hook) naar het in het abonnement opgenomen endpoint.

Abonnementen in Koppeltaal worden verder gespecificeerd in de developer guide.