Leeswijzer

Deze publicatie bevat specificaties m.b.t. het gebruik van de AORTA on FHIR (AoF) infrastructuur. Deze infrastructuur bestaat uit meerdere verschillende componenten. GBx-applicaties kunnen m.b.v. deze componenten gegevens met elkaar uitwisselen.

De specificaties zijn bedoeld voor:

• ontwikkelpartners van VZVZ die AoF componenten willen bouwen;

• leveranciers van xIS’en die willen weten op welke wijze zij de AoF componenten kunnen gebruiken;

• medewerkers van VZVZ die AoF specificaties nodig hebben bij het vervullen van hun functie.

De volgende specificaties zijn van toepassing voor leveranciers van xIS'en.

AORTA on FHIR Features:

• deze bevat een overzicht van alle in AORTA geboden functionaliteit in termen van Features,

• inclusief de wijzigingen van deze Features in relatie tot de vorige versie ervan, en

• een overzicht van alle systeemrollen die een GBx-applicatie kan implementeren.

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.

AORTA Stelselnode:

• hier is de interface beschreven voor het verkrijgen van een AORTA Stelseltoken, dit token bevat de URL’s van alle componenten die een rol spelen in de AORTA infrastructuur.

• ook is hier een overzicht te vinden van alle beschikbare FHIR en v3 interacties.

GBx-applicaties:

• Use Cases Resource Client (initiërende GBx-applicatie of reagerende GBZ-applicatie) - deze bevat te realiseren use cases, van waaruit interacties worden gestart met de Resource Broker, of wanneer een interactie wordt ontvangen op een callback interface (Abonnement Notificatie).

• Use Cases Resource Server (reagerende GBZ-applicatie) - 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).

Generieke aspecten m.b.t. interfaces:

• Interfaces Algemeen - generieke eisen voor server-to-server interfaces. Uitzonderingssituaties die kunnen optreden zijn altijd omschreven in de use case van de component die de betreffende interface biedt. Bijvoorbeeld, uitzonderingen die kunnen optreden bij gebruik van de Routing Info Interface, zoals geboden door de Adressering Server, zijn beschreven in Use Cases Adressering Server.

• Token specificaties - specificaties van gebruikte tokens.

Interfaces die worden gebruikt door Resource Clients:

• AORTA Stelsel Metadata Interface - verkrijgen van betrouwbare URL van, door Resource Client, aan te roepen interfaces.

• Routing Info Interface - verkrijgen van routeringsinformatie t.b.v. een, via de Resource Broker, te initiëren FHIR-interactie bij een specifieke Resource Server.

• AORTA Token Exchange Interface - verkrijgen van een AORTA access_token, dat nodig is om FHIR-interacties te kunnen initiëren bij de Resource Broker.

• AORTA FHIR Resource Broker Interface - initiëren van FHIR-interacties bij de Resource Broker zelf, of bij een of meerdere Resource Servers (via de Resource Broker).

• AORTA v3 Resource Broker Interface - initiëren van v3-interacties bij een of meerdere Resource Servers, via de Resource Broker.

• Applicatie Register Interface - activeren van TKID('s).

• Actualiteitsregister Interface - aanmelden/bijwerken, verwijderen en opvragen van entries in/bij de Verwijsindex/Actualiteitsregister.

• Abonnementenregister Interface - registeren, wijzigen, opvragen en verwijderen van Abonnementen op Notificaties bij wijzigingen in Verwijsindex/Actualiteitsregister of in de Toegangslog.

Interfaces die worden geboden door Resource Clients (callback):

• Abonnement Notificatie Interface - ontvangen van notificaties n.a.v. een genomen Abonnement.

Interfaces die worden gebruikt door Resource Servers:

• AORTA Stelsel Metadata Interface - verkrijgen van betrouwbare URL van, door Resource Server, aan te roepen interfaces en van FQDN van betrouwbare clients die een Resource Server kunnen aanroepen.

• AS Metadata Interface - verkregen van JWKS t.b.v. controle van signature AORTA access_token.

Interfaces die worden geboden door Resource Servers:

• AORTA CapabilityStatement Interface - interface wordt door Resource Broker aangeroepen t.b.v. toetsing connectiviteit.

• AORTA FHIR Resource Interface - te implementeren AORTA-specifieke schil (HTTP-headers) om, door Resource Server geboden FHIR-interfaces.

Programma's van Eisen:

• Programma van Eisen GBx - deze bevat generieke eisen die van toepassing zijn op GBx-applicaties en GBx'en.

Wijzigingen voor reeds op AoF 0.7 aangesloten bronsystemen (Resource Servers):

1. Aanscherping gebruik van OperationOutcomes m.b.t. gebruikte zoekparameters.

2. Aanpassen scope van AORTA access_token naar SMART-on-FHIR v2. Inclusief fine-grained scopes.

3. CapabilityStatement kunnen opleveren voor alle ondersteunde fhir-versions.

4. Consent_token mag slechts worden gesigned met een UZI-servercertificaat.

5. Aanpassing (interface) Adressering Server.

6. Toevoeging van major versienummer aan niet-fhir interfaces van componenten.

7. AORTA-Version header optioneel gemaakt op RB *-in interfaces.