Leeswijzer AoF - 0.7.x
De volgende specificaties zijn van toepassing voor leveranciers van xIS'en.
Overzichten:
- Globaal ontwerp - deze bevat een overzicht van de betrokken systemen/componenten en een set sequence diagrammen, waarin de flow die wordt gevolgd voor verschillende interacties is beschreven. MUST-READ om te begrijpen hoe AORTA on FHIR werkt.
- Overzicht interacties, versies en systeemrollen - deze bevat een overzicht van alle (versies van) HL7-FHIR en HL7v3 interacties en van de bijbehorende AORTA systeemrollen waarvoor een xIS kan worden gekwalificeerd en geaccepteerd.
Programma's van Eisen:
- Programma van Eisen GBx - deze bevat generieke eisen die van toepassing zijn op GBx-applicaties en GBx'en.
Use cases:
- UC Resource Client (initiërend xIS of reagerend xIS) - deze bevat te realiseren use cases, van waaruit interacties worden gestart met de Resource Broker.
- UC Resource Server (reagerend xIS) - deze bevat te realiseren use cases, waarbij een onderverdeling is gemaakt tussen
- use cases die worden getriggered door een FHIR-interactie (xIS'en die een HL7-FHIR koppelvlak bieden).
- use cases die worden getriggered door een HL7v3-interactie (xIS'en die een HL7v3 koppelvlak bieden).
- use cases of use case onderdelen die van toepassing kunnen zijn op zowel FHIR- als op HL7v3-koppelvlakken.
- in de use cases wordt verwezen naar een informatieblok "Gegevensdienst-specifieke UC extensions en implementatiehandleidingen". Dit informatieblok kun je vinden op de use cases pagina en het bevat verwijzingen naar de implementatiehandleidingen die van toepassing is op een bepaalde uitwisseling (HL7v3 of HL7-FHIR).
Interfaces:
- Interfaces common
- generieke eisen voor interfaces.
- te retourneren HTTP statuscodes, headers en FHIR OperationOutcomes in diverse situaties (de uitzonderingen in de use cases verwijzen naar deze afhandeling).
- Token specificaties - inhoud van de gebruikte tokens.
- AORTA FHIR-profielen - AORTA-specifieke toepassing van core FHIR-profielen die worden gebruikt in infrastructurele interacties (bijv. m.b.t. ACT/VWI).
- AORTA Stelsel Interfaces - bevat interface voor het verkrijgen van een AORTA Stelseltoken, met informatie over adressen van componenten die een rol vervullen in het AORTA-netwerk.
- Autorisatie Server Interfaces - bevat een aantal interfaces die moeten worden gebruikt door Resource Clients voor het verkrijgen van access_tokens, en door Resource Servers t.b.v. controle van access_tokens (metadata en JWKS).
- Resource Broker Interfaces - bevat interfaces voor Resource Clients
- voor infrastructurele interacties, bijv. TKID-activatie en interacties m.b.t. ACT/VWI.
- om FHIR-interacties te kunnen initiëren.
- Resource Server Interfaces - deze bevat alle FHIR- en HL7v3-interfaces die kunnen worden gerealiseerd door een xIS.
- Transformatie Server Interfaces - interfaces t.b.v. transformatie tussen HL7-v3 en HL7-FHIR (wordt slechts gebruikt door de Resource Broker).
Wijzigingen voor reeds op AoF 0.6 aangesloten bronsystemen:
- AORTA Stelseltoken
- Periodiek ophalen van AORTA Stelseltoken bij de AORTA Stelselnode.
- Resource Endpoint
- FHIR version toegevoegd aan base-URL van Resource Server indien hoger dan STU3.
- JWK
- Issuer van AORTA access_token moet zijn opgenomen in het AORTA Stelseltoken.
- Cache-control header toegevoegd aan metadata en jwks responses.
- Bij selectie juiste JWK, naast kid, ook kty en use attribuut gebruiken.
- Metadata en JWK moeten worden opgehaald via GZN.
- AORTA access_token
- Kunnen verwerken van een nieuwe versie van AORTA access_token.
- FQDN van client_id in AORTA access_token moet worden getoetst m.b.v. het AORTA Stelseltoken.
- Ontvangers van een AORTA access_token dienen geen replay detectie te doen op het token, omdat de scope van een token meerdere interacties kan bevatten, die ook sequentieel kunnen worden uitgevoerd.
- TKID-activatie
Technische aanpassing in interface voor TKID activatie (versienummer toegevoegd om versiebeheer te kunnen ondersteunen, app-id gewijzigd in applicationId om consistent te zijn met andere API's)