Use cases Notificatie Broker

Mitz

Mitz Notificatie Broker

Resource Client (GBx-applicatie)

AOF.UC.NBR.100.v7

relayMitzNotification

De primaire actor is aangesloten op het systeem.

Het systeem is slechts benaderbaar voor

• Mitz componenten die zijn aangesloten op het AORTA netwerk

Stap

Omschrijving

i

Het systeem ontvangt een verzoek en start de verwerking.

Het systeem toetst of het gevraagde type content (Accept header) en het gehanteerde type content (Content-Type header) worden ondersteund.

NB. wanneer het verzoek wordt ontvangen van een component van VZVZ, dan hoeft geen toets op type content te worden uitgevoerd.

Gevraagd type content niet ondersteund

statuscode 406 Not Acceptable

• Deze situatie kan slechts optreden wanneer requests worden ontvangen via HTTP(S)

Gehanteerd type content niet ondersteund

statuscode 415 Unsupported Media Type

• Deze situatie kan slechts optreden wanneer requests worden ontvangen via HTTP(S)

Het systeem genereert de vereiste response en gaat verder met de exit stap van de main flow.

Stap

Omschrijving

i

Het systeem toetst of het request geen malafide inhoud bevat  (zie FHIR security, input validation).

Ongeldig verzoek

statuscode 400 Bad Request

Het systeem genereert de vereiste response en gaat verder met de exit stap van de main flow.

ii

Het systeem toetst of het verzoek voldoet aan de interface specificatie.

Hierbij moet ook worden voldaan aan de toelichting "Controle van batch en transaction requests".

FHIR-requests dienen te worden getoetst tegen de core FHIR specificaties (RESTful API).

Indien een If-None-Exists HTTP header van toepassing is op de interactie, dan dient deze te worden behandeld als een reguliere zoekparameter.

Indien een specifieke FHIR-profiel van toepassing is voor het gevonden interactie-id, dan dient het FHIR-request hier ook tegen te worden getoetst. NB. toetsing tegen een volledig FHIR-profiel wordt nog niet gedaan - consequenties van deze toets worden eerst in kaart gebracht.

Ongeldig verzoek

statuscode 400 Bad Request

Het systeem genereert de vereiste response en gaat verder met de exit stap van de main flow.

1 <exit>

Het systeem retourneert een response naar de primaire actor.

Zie ook de eisen die Mitz stelt aan de verwerking van notificaties.

Verwerking succesvol

statuscode 200 OK

2

Het systeem haalt de status van het Lokaliseerbaar Systeem in het Applicatieregister op m.b.v. feature migratedToMitz.

Mitz migratie status kan niet worden vastgesteld

Het systeem beëindigt de flow.

3

Indien de status van het Lokaliseerbaar Systeem niet gelijk is aan “Migrated“, wordt de Mitz-notificatie doorgestuurd en eindigt de flow.

4

Het systeem haalt alle gegevenssoorten en bouwstenen die geregistreerd staan voor de combinatie van BSN/AppID op uit het Actualiteitsregister m.b.v. feature getEntries.

Actualiteitsregister entries kunnen niet worden opgehaald

Het systeem beëindigt de flow.

5

Alle gevonden records worden behandeld als abonnement gebeurtenis. De gebeurtenis wordt afgehandeld door het Abonnementenregister m.b.v. feature subscriptionNotification

Abonnement notificatie kan niet gestuurd worden

Het systeem beëindigt de flow.

6

Het systeem verkrijgt, m.b.v. Feature getApplication(s), informatie over het Lokaliseerbaar Systeem.

Bronhouder onbekend

Het systeem beëindigt de flow.

7

Indien het Lokaliseerbaar Systeem Mitz Toestemming Notificaties wil en kan ontvangen:

• Het systeem bepaalt m.b.v. de geregistreerde conformances in het APR (verkregen in een vorige stap) of een FHIR- of een v3-notificatie moet worden uitgestuurd.

De FQDN waarop een notificatie moet worden afgeleverd wordt eveneens verkregen uit het APR.

8

Het systeem verstuurt de notificatie via het bestaande mechanisme voor guaranteed delivery, op de wijze zoals gespecificeerd in

• HL7-FHIR: de Toestemming Notificatie Interface;

• HL7v3: Toestemmings Notificatie (Optioneel)

Het systeem heeft ontvangen request en de geretourneerde response gelogd, zoals beschreven in de Toelichting Logging.

Het systeem heeft eventueel opgetreden fouten die ertoe hebben geleid dat de notificatie niet kan worden doorgestuurd gelogd. De volgende attributen worden gelogd:

• datum en tijd van de opgetreden fout

• request-id van het initiële verzoek (de notificatie van Mitz)

• omschrijving van de opgetreden fout

Het systeem heeft van het ontvangen request, de volgende attributen gelogd:

• datum en tijd van ontvangst

• request-id

• initial-request-id (indien van toepassing)

• sender-id (common name van de TLS-client die de notificatie verzendt)

• receiver-id (role-id van de VZVZ component die de notificatie ontvangt)

==

Het systeem heeft voor ieder uitgaand request, dat bij het doorlopen van de use case werd verzonden, de volgende attributen gelogd:

• datum en tijd van verzending

• request-id

• initial-request-id

• receiver-id

  • role-id wanneer de receiver van het request een VZVZ component is, en de aanroep niet via HTTP geschiedt

  • FQDN wanneer de aanroep via HTTP geschiedt

Het systeem heeft van de geretourneerde response, de volgende attributen gelogd:

• datum en tijd van response

• request-id van het bijbehorende request

• initial-request-id van het bijbehorende request (indien van toepassing)

• sender-id (role-id van de VZVZ component die de response verzendt)

• receiver-id (common name van de TLS-client die de response ontvangt)

• HTTP statuscode en eventueel geretourneerde foutinformatie

==

Het systeem heeft voor iedere response, die bij het doorlopen van de use case werd ontvangen, de volgende attributen gelogd:

• datum en tijd van response

• request-id van het bijbehorende request

• initial-request-id van het bijbehorende request

• sender-id

  • role-id wanneer de sender van de response een VZVZ component is, en de aanroep niet via TLS geschiedt

  • common name wanneer de aanroep via TLS geschiedt

• HTTP statuscode en eventueel geretourneerde foutinformatie