kwalificatie:V1.0 Handleiding Conformancelab - Bewerkingsoverzicht

Pieter Edelman: Beveiligde "kwalificatie:V1.0 Handleiding Conformancelab": Protect production page from accidental edits ([Bewerken=Alleen beheerders toestaan] (vervalt niet) [Hernoemen=Alleen beheerders toestaan] (vervalt niet))

2026-07-21T07:32:05Z

Beveiligde "kwalificatie:V1.0 Handleiding Conformancelab": Protect production page from accidental edits ([Bewerken=Alleen beheerders toestaan] (vervalt niet) [Hernoemen=Alleen beheerders toestaan] (vervalt niet))

Pieter Edelman: Publish prepub to live environment

2026-07-21T07:32:05Z

Publish prepub to live environment

Pieter Edelman: Gekopieerd van kwalificatie:Vprepub-1.0 Handleiding Conformancelab, versie 242471

2026-07-21T07:32:04Z

Gekopieerd van kwalificatie:Vprepub-1.0 Handleiding Conformancelab, versie 242471

Lisa Dekker: CLI-126 Conformancelab handleiding vanuit Interoplab toevoegen

2026-07-14T06:46:56Z

CLI-126 Conformancelab handleiding vanuit Interoplab toevoegen

Lisa Dekker: CLI-99 Volgorde test aanpassen adhv nieuwe functionaliteit Request-modes

2026-07-14T06:45:32Z

CLI-99 Volgorde test aanpassen adhv nieuwe functionaliteit Request-modes

Lisa Dekker: CLI-16: toevoeging PRT + opt-in link

2026-01-23T13:00:44Z

CLI-16: toevoeging PRT + opt-in link

Lisa Dekker: ZIBFHIR-363: Conformancelab Tweezijdige authenticatie uitleg toegevoegd

2025-09-22T13:57:27Z

ZIBFHIR-363: Conformancelab Tweezijdige authenticatie uitleg toegevoegd

Pieter Edelman: ZIBFHIR-233: A generic manual for using Conformancelab with the Nictiz test materials has been added based on the Touchstone manual

2025-02-21T07:17:08Z

ZIBFHIR-233: A generic manual for using Conformancelab with the Nictiz test materials has been added based on the Touchstone manual

Nieuwe pagina

__NOINDEX__
__NUMBEREDHEADINGS__
{{kwalificatie:V1.0_Issuebox}}
<section begin="Introductie Conformancelab"/>
===Introductie Conformancelab===

Voor het testen en kwalificeren van FHIR-implementaties van informatiestandaarden biedt Nictiz het [https://conformancelab.nl/ Conformancelab-platform] aan van Interoplab. Nictiz stelt op dit platform testscripts beschikbaar die overeenkomen met de functionele testscripts bij een informatiestandaard.

====Testopzet client====
Bij testen waar de FHIR-client het testobject is ziet de testopstelling er als volgt uit:

[[Bestand:Conformancelab client.jpg|link= |750px]]

De opzet is hier als volgt:

* De client is het testobject van de leverancier.
* Conformancelab staat in het midden en stelt testen/testscripts, logging, validatie en overzicht beschikbaar.
* Daarachter staat een FHIR-server (HAPI FHIR) met de FHIR-profielen en testberichten passend bij de testscripts.

====Testopzet server====
Bij testen waar de FHIR-server het testobject is ziet de testopstelling er als volgt uit:

[[Bestand:Conformancelab server.jpg|link= |550px]]

De opzet is hier als volgt:
* Conformancelab stelt testen/testscripts, logging, validatie en overzicht beschikbaar. Daarnaast is Conformancelab ook een FHIR-client die interacties kan versturen volgens de testscripts.
* De server is het testobject van de leverancier.<section end="Introductie Conformancelab" /><section begin="Conformancelab-account"/>

===Conformancelab-account===
Als je gebruik wilt maken van Conformancelab is het aanmaken van een account nodig, ga hiervoor naar https://my.interoplab.eu/auth/register
<section end="Conformancelab-account"/><section begin="Uitvoeren van testen"/>
===Uitvoeren van testen===
Leveranciers kunnen zelfstandig de scripts die Nictiz publiceert uitvoeren en de resultaten bekijken. Hoe dit moet, wordt uitgelegd in de applicatie van Conformancelab zelf door middel van een in-app tutorial.

* Om toegang te krijgen tot pre-kwalificatietesten moet de tegel "Conformance - Test" worden geselecteerd.
* Om toegang te krijgen tot kwalificatietesten moet de tegel "Conformance - Cert" worden geselecteerd.
<section end="Uitvoeren van testen"/><section begin="Tokens"/>
===Mock-authenticatie met vaste tokens===
De authenticatie-stap is geen onderdeel van de Conformancelab-test. Authenticatie van de FHIR-requests via een Bearer-token wordt op Conformancelab nagebootst door het gebruik van vaste, niet-verlopende tokens.

Het gebruik hiervan verschilt per rol die wil testen of kwalificeren:
* Voor clients die getest worden, is er per testpatiënt uit het scenario [https://github.com/Nictiz/Nictiz-testscripts/blob/main/Configuration/QualificationTokens.json een Bearer-token gedefinieerd]. De client dient deze tokens te gebruiken in elke request naar kwalificatiesimulator.
* Bij servers die getest worden, wordt er tijdens het aanmaken van de test gevraagd om een Bearer-token voor elke testpatiënt. Conformancelab zal deze tokens gebruiken in de requests naar de server die getest wordt. Standaard zijn hier [https://github.com/Nictiz/Nictiz-testscripts/blob/main/Configuration/QualificationTokens.json dezelfde tokens] ingevuld die ook voor client-testen gebruikt worden, het staat gebruikers vrij om deze tokens over te nemen.<br />'''Let op''': De tokens moeten gedefinieerd worden als <q>Bearer<spatie>[token]</q>, bijvoorbeeld <q>Bearer 0aed465d-aab0-4417-9b3c-e6f635892fea</q> (zonder aanhalingstekens).
[[Bestand:Conformancelab Bearer token.png|link=|700px]]<section end="Tokens"/><section begin="Aandachtspunten"/>

===Aandachtspunten===
====Volgorde van tests====
Het kwalificatiescript vraagt om een vaste volgorde voor het sturen van requests, waar de informatiestandaard mogelijk meer ruimte laat om dit ook in een andere volgorde te doorlopen. Het is daarom van belang om bij het uitvoeren van testen op de kwalificatiesimulator de interacties uit te voeren in dezelfde volgorde waarin ze worden gevraagd in de testscripts.
====Ophalen van references====
Antwoorden uit de kwalificatiesimulator bevatten soms references naar extra informatie. Een voorbeeld uit de BGZ: {{fhir|<nowiki><reference value="Practitioner/medmij-bgz-practitioner-ts-02"/></nowiki>}}
Deze references zijn los op te halen bij de kwalificatiesimulator, maar omdat er een bepaalde volgorde van interacties wordt gevraagd, kan het tussendoor ophalen van references ervoor zorgen dat een test faalt. We raden in dat geval aan om: De references pas op te halen als de test op de kwalificatiesimulator is afgelopen. Het ophalen van references zal er dan niet meer voor zorgen dat testen falen.

Indien dat niet mogelijk is:

Testen 2 keer uit te voeren:
* De test één keer uit te voeren zonder het ophalen van references. Het doel hierbij is om aan te tonen dat de applicatie de juiste interacties kan versturen die worden gevraagd in het testscript.
* De test een tweede keer uit te voeren, maar dan zonder dat hiervoor een testrun is gestart op de kwalificatiesimulator. Tijdens deze test kunnen dan wel alle references tussendoor worden opgehaald. Het doel van deze test is om aan te tonen dat de applicatie goed om kan goed met de inhoud verstuurd tijdens de test, inclusief de los op te halen references.

====Infrastructuur====
Bij het gebruik van Conformancelab willen we de volgende punten onder de aandacht brengen:
* Conformancelab maakt geen gebruik van tweezijdige TLS-authenticatie.
====Vragen over uitvoer van testen====
Indien er vragen zijn over uitgevoerde testen is het voor ons van belang om gericht te kunnen terugvinden welke interacties er uitgewisseld zijn. Bij contact hierover vragen wij daarom om (indien mogelijk) een testrun uit te voeren op de kwalificatiesimulator. Stuur bij vragen daarover altijd de link mee van de uitgevoerde testrun. Deze heeft het formaat: <code><nowiki>https://my.interoplab.eu/uc-nictiz/tests/instance/</nowiki><unieke identifier></code><section end="Aandachtspunten"/><section begin="Variabele T datum"/>

===Variabele T-datum===
Test- en kwalificatiescenario's werken vaak met relatieve datums, die ervoor zorgen dat scenario's niet gedateerd raken. Een datum 'volgende week' blijft zodoende altijd in de toekomst. Om dit te vertalen naar concrete datums die gebruikt worden tijdens het testen en kwalificeren wordt gewerkt met de zogenaamde T-datum. De betekenis van deze T-datum en waar een deelnemer rekening mee moet houden bij het gebruik hiervan verschilt per rol. Voor iedere rol volgt hierna verdere uitleg.
====Server: beschikbaarstellen (serve) en client: sturen (send)====
Leveranciers die de inhoudelijke gegevens van test- en kwalificatiescenario's in hun bronsysteem invoeren ter voorbereiding op de Conformancelab-tests voor beschikbaarstellen (serve) of sturen (send), bepalen een T-datum die zij hanteren bij het invoeren van alle gegevens.

Wanneer de bepaalde T-datum bijvoorbeeld '2022-01-01' is en de kwalificatiescripts spreken van 'T + 400D', berekent de leverancier de datum die 400 dagen ná de bepaalde T-datum ligt. Die datum wordt vervolgens in het bronsysteem ingevoerd bij het betreffende veld – in dit voorbeeld dus '2023-02-05'.

Mogelijke eenheden die gebruik worden bij het verrekenen van de T-datum zijn 'D' (dagen), 'M' (maanden) en 'Y' (jaren).

Wanneer er datums gebruikt worden in de testscenario's, die invloed hebben op de Conformancelab-scripts, bijvoorbeeld in de zoekparameters van het scenario "Persoon 1 vraagt alle meetwaarden op in een periode ('T – 30D t/m T')", wordt ook bij het uitvoeren van het betreffende Conformancelab-script gevraagd de bepaalde T-datum in te voeren. Conformancelab berekent vervolgens zelf de exact benodigde datums. Als de T-datum van het Conformancelab-script overeenkomt met die van de ingevoerde gegevens, worden de gevraagde resources opgeleverd.

De verwachting is dat een leverancier de gebruikte T-datum vermeldt bij het aanleveren van de materialen en dat deze datum correspondeert met de aangeleverde screenshots en Conformancelab-testrun(s).
====Server: ontvangen (receive) en client: ophalen (retrieve)====
Leveranciers die gegevens ophalen of ontvangen tijdens het gebruik van Conformancelab, ontvangen testberichten van HAPI FHIR. Elke maandag worden de gegevens op HAPI FHIR ververst, waarbij alle datums opnieuw worden berekend met de datum van die maandag als referentie.

Als een client gegevens ophaalt in de week van '2022-08-01', zal, indien het kwalificatiescript spreekt van een veld met als datum 'T + 400D', er een resource opgehaald worden waarin dat betreffende veld gevuld is met de datum '2023-09-05'.

Wanneer er datums gebruikt worden in de testscenario's, die invloed hebben op de Conformancelab-scripts, bijvoorbeeld in de zoekparameters van het scenario "Persoon 1 vraagt alle meetwaarden op in een periode ('T – 30D t/m T')", wordt ook bij het uitvoeren van het betreffende Conformancelab-script gevraagd de T-datum in te voeren. Hier dient dus de datum van de maandag uit de testweek te worden ingevuld. Conformancelabberekent vervolgens zelf de exact benodigde datums. Als de T-datum van het Conformancelab-script overeenkomt met de datum die gebruikt is tijdens het verversen van HAPI FHIR, worden de gevraagde resources opgeleverd.

De verwachting is dat een client tijdens kwalificatie in screenshots datums laat zien die corresponderen met gegevens die opgehaald zijn tijdens de aangeleverde Conformancelab-testrun(s).
===Tijdzones===
In de FHIR-datatypes {{datatype|dateTime}} (indien uren en minuten worden gebruikt) en {{datatype|instant}} is het verplicht om een tijdzone in te vullen. De tijdzone kan daarom niet worden weglaten uit de testgegevens. De testopzet heeft helaas de beperking dat de Nederlandse tijdzone niet berekend kan worden aan de hand van de T-datum. De tijdzone die nu in onze testgegevens staat is daarom de Nederlandse tijdzone bij de eerste keer invullen van dit scenario met concrete datums. Dit komt niet per definitie overeen met de geldende tijdzone in Nederland voor de (in een testrun gebruikte, uiteindelijke) datum. In productie moet gerekend worden op een juiste tijdzone en het is dan ook juist om deze tijdzone gewoon te interpreteren, dit betekent dat de gegevens mogelijk soms een uur later of vroeger zijn dan in het addendum staat. Dit is geen reden voor afkeuren tijdens kwalificatie.
<section end="Variabele T datum"/>

← Oudere versie		Versie van 21 jul 2026 om 07:32
Regel 1:		Regel 1:
−	~~__NOINDEX__~~
	__NUMBEREDHEADINGS__		__NUMBEREDHEADINGS__
	{{kwalificatie:V1.0_Issuebox}}		{{kwalificatie:V1.0_Issuebox}}

← Oudere versie		Versie van 23 jan 2026 om 13:00
Regel 6:		Regel 6:

	Voor het testen en kwalificeren van FHIR-implementaties van informatiestandaarden biedt Nictiz het [https://conformancelab.nl/ Conformancelab-platform] aan van Interoplab. Nictiz stelt op dit platform testscripts beschikbaar die overeenkomen met de functionele testscripts bij een informatiestandaard.		Voor het testen en kwalificeren van FHIR-implementaties van informatiestandaarden biedt Nictiz het [https://conformancelab.nl/ Conformancelab-platform] aan van Interoplab. Nictiz stelt op dit platform testscripts beschikbaar die overeenkomen met de functionele testscripts bij een informatiestandaard.
		+
		+	====PRT====
		+	De Patchrelease-Train (PRT) is het Nictiz-proces voor een voorspelbare en betrouwbare releasecyclus van informatiestandaarden. In dit proces worden uitsluitend backwards-compatible wijzigingen (patches) doorgevoerd. De PRT werkt met een vaste 4-wekelijkse cadans en doorloopt vijf fasen.
		+
		+	Tijdens elke cyclus zijn er twee communicatiemomenten. In week 2 ontvangen stakeholders een voorgenomen releasebericht met de geplande patches. Dit biedt jullie de mogelijkheid om feedback te geven of vragen te stellen via de bijbehorende Jira-tickets. Na afronding van de cyclus volgt het definitieve releasebericht. Dankzij duidelijke checks en balances borgt de PRT een betrouwbare release.
		+
		+	Wat betekent dit voor jou als leverancier?
		+
		+	Algemene wijzigingen vanuit de leverancier of Nictiz die impact hebben op het gebruik van de Nictiz instantie van Conformancelab, worden meegenomen in de PRT.
		+
		+	Updates lopen via een geautomatiseerd mailsysteem. Schrijf je hier in om op de hoogte te blijven van de wijzigingen:
		+
		+	[https://laposta.nl/f/ssxrljwfcvw7 opt-in link]
		+
		+	{{font color\|red\|Belangrijk: na het aanklikken van de opt-in link word je in de browser doorgestuurd naar een unieke URL. Kopieer of deel deze URL NIET. Gebruik uitsluitend de opt-in link hierboven; anders kan er een AVG-probleem ontstaan.}}

	====Testopzet client====		====Testopzet client====

← Oudere versie	Versie van 21 jul 2026 om 07:32
(geen verschil)

@@ Regel 46: / Regel 46: @@
 <section end="Conformancelab-account"/><section begin="Uitvoeren van testen"/>
 ===Uitvoeren van testen===
-Leveranciers kunnen zelfstandig de scripts die Nictiz publiceert uitvoeren en de resultaten bekijken. Hoe dit moet, wordt uitgelegd in de applicatie van Conformancelab zelf door middel van een in-app tutorial.
+Leveranciers kunnen zelfstandig de scripts die Nictiz publiceert uitvoeren en de resultaten bekijken. Hoe dit moet, wordt uitgelegd in Conformancelab door middel van een in-app tutorial. Ook is er [https://interoplab.atlassian.net/wiki/spaces/SUP/pages/4085317648/Conformancelab+-+General een handleiding beschikbaar].
 * Om toegang te krijgen tot pre-kwalificatietesten moet de tegel "Conformance - Test" worden geselecteerd.

@@ Regel 60: / Regel 60: @@
 ===Aandachtspunten===
-====Volgorde van tests====
+====Volgorde van tests en ophalen van references====
-Het kwalificatiescript vraagt om een vaste volgorde voor het sturen van requests, waar de informatiestandaard mogelijk meer ruimte laat om dit ook in een andere volgorde te doorlopen. Het is daarom van belang om bij het uitvoeren van testen op de kwalificatiesimulator de interacties uit te voeren in dezelfde volgorde waarin ze worden gevraagd in de testscripts.
+Conformancelab bepaalt tijdens een testrun welke interactie op dat moment wordt verwacht. Standaard moeten requests worden afgehandeld in de volgorde zoals deze in het kwalificatiescript zijn opgenomen. Extra requests, bijvoorbeeld voor het ophalen van references, kunnen in dat geval invloed hebben op het verloop van de test.
-====Ophalen van references====
-Antwoorden uit de kwalificatiesimulator bevatten soms references naar extra informatie. Een voorbeeld uit de BGZ: {{fhir|<nowiki><reference value="Practitioner/medmij-bgz-practitioner-ts-02"/></nowiki>}}
+Voor sommige testen is een minder strikte afhandeling ingericht via zogenaamde ''request modes''. Controleer daarom tijdens het uitvoeren van de test welke ''request mode'' in Conformancelab wordt getoond. Zie voor verdere toelichting [https://interoplab.atlassian.net/wiki/spaces/SUP/pages/4095410178/Running+tests#Request-modes de Interoplab handleiding]
-Deze references zijn los op te halen bij de kwalificatiesimulator, maar omdat er een bepaalde volgorde van interacties wordt gevraagd, kan het tussendoor ophalen van references ervoor zorgen dat een test faalt. We raden in dat geval aan om: De references pas op te halen als de test op de kwalificatiesimulator is afgelopen. Het ophalen van references zal er dan niet meer voor zorgen dat testen falen.
+Als een test een ''request mode'' gebruikt waarbij extra requests zijn toegestaan of waarbij de volgorde van de requests niet uitmaakt, kunnen references tijdens de testrun worden opgehaald zonder dat dit de testflow verstoort.
-Indien dat niet mogelijk is:
+Is deze functionaliteit voor de betreffende informatiestandaard of test nog niet ingericht, dan geldt de standaard werkwijze: voer de interacties uit in de volgorde waarin Conformancelab deze vraagt. Haal references dan bij voorkeur pas op nadat de testrun is afgerond.
-Testen 2 keer uit te voeren:
-* De test één keer uit te voeren zonder het ophalen van references. Het doel hierbij is om aan te tonen dat de applicatie de juiste interacties kan versturen die worden gevraagd in het testscript.
+Indien dit niet mogelijk is, kan de test twee keer worden uitgevoerd:
-* De test een tweede keer uit te voeren, maar dan zonder dat hiervoor een testrun is gestart op de kwalificatiesimulator. Tijdens deze test kunnen dan wel alle references tussendoor worden opgehaald. Het doel van deze test is om aan te tonen dat de applicatie goed om kan goed met de inhoud verstuurd tijdens de test, inclusief de los op te halen references.
+* één keer met een actieve testrun, zonder tussentijds ophalen van references. Hiermee wordt aangetoond dat de applicatie de juiste interacties kan versturen zoals gevraagd in het kwalificatiescript;
 ====Infrastructuur====

@@ Regel 56: / Regel 56: @@
 * De test één keer uit te voeren zonder het ophalen van references. Het doel hierbij is om aan te tonen dat de applicatie de juiste interacties kan versturen die worden gevraagd in het testscript.
 * De test een tweede keer uit te voeren, maar dan zonder dat hiervoor een testrun is gestart op de kwalificatiesimulator. Tijdens deze test kunnen dan wel alle references tussendoor worden opgehaald. Het doel van deze test is om aan te tonen dat de applicatie goed om kan goed met de inhoud verstuurd tijdens de test, inclusief de los op te halen references.
-====Infrastructuur====
+Bij het gebruik van Conformancelab gelden de volgende aandachtspunten:
-Bij het gebruik van Conformancelab willen we de volgende punten onder de aandacht brengen:
+; Ondersteuning voor tweezijdige TLS-authenticatie: Conformancelab biedt de mogelijkheid om gebruik te maken van tweezijdige TLS-authenticatie (mTLS). Dit sluit aan bij de gangbare praktijk binnen de Nederlandse zorguitwisselingen. Hiervoor wordt een '''PKIoverheid-certificaat (PKIo)''' gebruikt.
-* Conformancelab maakt geen gebruik van tweezijdige TLS-authenticatie.
+; Optioneel gebruik van certificaten: Zowel aan de clientzijde als aan de serverzijde kan een certificaat worden ingesteld. Het gebruik van mTLS is daarmee optioneel. Het te testen systeem kan echter expliciet vereisen dat TLS-authenticatie wordt afgedwongen.
 ====Vragen over uitvoer van testen====
 Indien er vragen zijn over uitgevoerde testen is het voor ons van belang om gericht te kunnen terugvinden welke interacties er uitgewisseld zijn. Bij contact hierover vragen wij daarom om (indien mogelijk) een testrun uit te voeren op de kwalificatiesimulator. Stuur bij vragen daarover altijd de link mee van de uitgevoerde testrun. Deze heeft het formaat: <code><nowiki>https://my.interoplab.eu/uc-nictiz/tests/instance/</nowiki><unieke identifier></code><section end="Aandachtspunten"/><section begin="Variabele T datum"/>