HL7v3 kwalificatiesimulator

Uit informatiestandaarden
Versie door Jasper Theunissen (overleg | bijdragen) op 17 feb 2023 om 15:11 (Validatie tegen informatiestandaarden)
Ga naar: navigatie, zoeken

1 Algemeen

Voor de uitwisseling van medische informatie maken zorgaanbieders gebruik van zorginformatiesystemen. Deze zogenaamde XIS-applicaties maken gebruik van informatiestandaarden zoals door Nictiz worden ontwikkeld. Nictiz biedt leveranciers de mogelijkheid hun producten en diensten te laten toetsen (kwalificeren) op correcte implementatie van informatiestandaarden. Om gegevens uit te wisselen via de landelijke infrastructuur voor zorgcommunicatie verlangt VZVZ dat de betreffende zorginformatiesystemen “XIS-type” gekwalificeerd zijn. Als ICT-leverancier kunt u zich voor een zorgtoepassingkwalificatie aanmelden bij Nictiz.

2 Aanmelden voor kwalificatie

In de informatiestandaarden staat per zorgtoepassing beschreven met welke berichtstructuur en volgens welke eisen informatie wordt uitgewisseld. U zorgt dat u met uw pakket voldoet aan de eisen die horen bij een specifieke zorgtoepassing. Wanneer uw software voldoet aan de eisen voor een zorgtoepassing (zie ook paragraaf 2.4), kunt u zich voor kwalificatie aanmelden bij Nictiz.

U meldt zich aan door een e-mail te sturen naar kwalificatie@nictiz.nl. Om uw kwalificatie adequaat in behandeling te kunnen nemen vernemen wij graag van u de gevraagde informatie uit paragraaf 2.1.1. Zodra we uw aanmelding hebben ontvangen neemt de kwalificatie-coördinator contact met u op om de kwalificatie in te plannen en afspraken te maken over het verloop van het kwalificatietraject.

Voor nieuwe leveranciers Mocht u nog niet beschikken over een OID voor o.a. bericht-id’s en dergelijke, vraag dan een eigen OID aan. Zie voor meer informatie: https://informatiestandaarden.nictiz.nl/wiki/OID

3 Hoe verloopt het kwalificatieproces?

De zorgtoepassingkwalificatie, ook wel XIS-kwalificatie genoemd, bestaat uit het doorlopen van een of meerdere scenario’s waarbij berichten worden uitgewisseld en gegevens op schermen worden getoond. Tijdens deze kwalificatie controleert Nictiz of de berichten aan deze eisen voldoen en of de systemen de informatie op een juiste manier aan de gebruiker tonen.

Het kwalificatietraject verloopt als volgt:

  • Leverancier meldt zich aan voor kwalificatie(s) (zie paragraaf H-1).
  • Nictiz verstrekt kwalificatiescripts die door de softwareleverancier doorlopen moeten worden.
  • Leverancier levert informatie aan voor het configureren van kwalificatieaccount (zie paragraaf 2.1.1).
  • Nictiz verstrekt de gegevens om de applicatie aan te sluiten op de kwalificatiesimulator (zie paragraaf 2.1.2).
  • Nictiz verstrekt de inloggegevens om in te loggen op de kwalificatiesimulator.
  • Connectiviteit met de kwalificatiesimulator wordt door de softwareleverancier en Nictiz getest.
  • Leverancier test zelfstandig op basis van kwalificatiescripts op de kwalificatiesimulator en geeft aan klaar te zijn via kwalificatie@nictiz.nl
  • Nictiz gaat een kwalificatieronde inplannen.
  • Het zorginformatiesysteem wordt conform verstrekte kwalificatiescripts getoetst. Bij kwalificatie geldt altijd dat die gepland plaatsvinden waarbij de berichtenlog van een kwalificatieaccount dat daarvoor voor testen is gebruikt, wordt vooraf geleegd door Nictiz.
  • Nictiz verzamelt de verstuurde berichten.
  • De softwareleverancier levert, waar dat gevraagd wordt in scripts, zelf schermafdrukken op waaruit blijkt dat de informatie goed is binnengekomen. Neem de schermafdrukken op in het kwalificatiescript en stuur die door naar kwalificatie@nictiz.nl
  • Door inspectie van ingeleverd materiaal controleert Nictiz of:
    • aan alle eisen is voldaan die betrekking hebben op de medische inhoud van de uitwisseling;
    • de gegevens op een juiste manier aan de gebruiker getoond worden.

Bevindingen, en onderwerpen waarover onduidelijkheid bestaat of deze een bevinding zijn, worden vastgelegd in een kwalificatierapport. Dat rapport wordt uiterlijk binnen twee weken teruggestuurd.

  • Als de kwalificatie is behaald, ontvangt de softwareleverancier een certificaat voor het betreffende zorginformatiesysteem.
  • Indien het kwalificatietraject niet goed is doorlopen volgt een periode waarin de leverancier de gelegenheid krijgt om de bevindingen die aanpassing van de XIS-applicatie verlangen door te voeren.
  • Zodra de softwareleverancier aangeeft alle bevindingen opgelost te hebben, zal er een nieuwe kwalificatieronde ingepland worden om minimaal alle openstaande bevindingen te hertesten.

3.1 Kwalificatiesimulator

Nictiz organiseert de zorgtoepassingkwalificatie tegenwoordig zoveel mogelijk remote en via internet met behulp van een kwalificatiesimulator. Nictiz gebruikt hiervoor een kwalificatiesimulator op basis van ART-DECOR . Het voordeel van het gebruik van deze tool is dat:

  • kwalificatie online of binnen de zorginfrastructuur kan gebeuren;
  • kwalificatie kan plaatsvinden op het moment dat het de softwareleverancier zelf uitkomt;
  • kwalificatie laagdrempelig is omdat UZI-passen en certificaten niet nodig zijn;
  • meerdere kwalificaties tegelijkertijd kunnen plaatsvinden;
  • de respons voorspelbaar is;
  • de leverancier zelf inzicht heeft in de verstuurde berichten/documenten en validatieresultaten;
  • de leverancier de mogelijkheid heeft om zichzelf te bevragen, of berichten naar zichzelf te sturen.

De simulator biedt tijdens de ontwikkeling de mogelijkheid om vooraf gedefinieerde inhoud terug te geven (zoals beschreven in de scripts). Hiermee kan de leverancier kijken of hij de data goed ontvangt en toont. Merk op dat hier vaak vaste inhoud teruggestuurd wordt en dat de simulator geen interne logica heeft voor bijvoorbeeld verwijsindex en query filters. Ook kan de simulator het systeem bevragen in geval dat het systeem een bronsysteem is. Daarbij is het mogelijk om de patiënt, auteur en query parameters aan te passen. Op het moment dat de patiënt niet aanwezig is in de lijst, kan de BSN ook handmatig worden ingevuld.

De simulator heeft voor de vaste huisarts ook de mogelijkheid om een waarneembericht naar het bronsysteem te sturen, zo kan de leverancier controleren of hij het waarneembericht kan ontvangen en verwerken. De beschikbare waarneemberichten zijn de berichten die ook in het script van de vaste huisarts worden genoemd.

De kwalificatiesimulator verzamelt berichten die van en naar een leverancier worden gecommuniceerd in een berichtenlog. Het is voor de leverancier mogelijk om zelf de berichtenlog in te zien, inclusief validatieresultaten.

Algemene opmerkingen over het gebruik van de kwalificatiesimulator:

  • de kwalificatiesimulator is niet bedoeld voor loadtesten, maar voor inhoudelijke controles tegen informatiestandaarden;
  • Nictiz vereist verantwoord gebruik van deze kwalificatiesimulator, neem bij twijfel over gebruik contact op. 

3.1.1 Connectiviteitstest: in te vullen door leverancier

Als voorbereiding op een kwalificatie zal het kwalificatieteam een kwalificatieaccount opzetten op onze simulator. Hiermee is het mogelijk om berichten/document in te sturen/te ontvangen uit onze simulator naar de applicatie bij de leverancier.

Voor het configureren van kwalificatieaccount(s) heeft Nictiz de volgende gegevens nodig per systeem:

  • De zorgtoepassingrol(len) waarvoor u zich wenst te kwalificeren:
  • De naam van de te kwalificeren applicatie:
  • Het versienummer van de te kwalificeren applicatie:
  • Te gebruiken applicatieId (mag fictief zijn):
  • Naam van het systeem (menselijk leesbare naam, handig voor het onderscheid van systemen als er meerdere testsystemen aan een kwalificatieaccount zijn gekoppeld):
  • URL (of IP/map):

Bijvoorbeeld zonder certificaten: http://systeem1.zorgverlener.com/map/ Of met certificaten: https://systeem1.zorgverlener.com/map/

  • Systeem bij leverancier maakt gebruik van HTTPS: ja/nee/nvt

Dit is alleen van toepassing voor verkeer van de simulator naar het systeem bij de leverancier. Vul ja in als er een certificaat wordt gebruikt op het systeem.

  • Keuze kwalificatiesimulator: 1) http(s)://kwalificatie.nictiz.nl of 2) http(s)://nictiz.ks1.lsp.aorta-zorg.nl

(zie par 2.1.2)

  • Welke personen toegang moeten hebben tot het account? Geef daarbij graag aan: naam, organisatie, email-adres.

ApplicatieID's
Het is mogelijk om zelf een voorstel te doen voor applicatieId's. Het zou kunnen dat die applicatieId's al in gebruik zijn, in dat geval zullen we even contact opnemen om een tegenvoorstel door te spreken. Als er geen applicatieId wordt opgegeven zullen we dat uitdelen. NB: meerdere accounts met dezelfde applicatieId geeft een conflict.

GBZ-id’s
NB: GBZ-id's zijn in het kader van kwalificatie niet van belang en worden niet uitgedeeld voor kwalificatiesystemen. NB: Deze simulator checkt geen tokens en dergelijke. Nictiz concentreert zich op de inhoud van de berichten.

Testen connectiviteit
Als firewallconfiguraties en dergelijke zijn afgerond, test dan zelf of de connectiviteit werkt. Mochten hier problemen mee zijn, geef dat dan graag even aan, dan maken we een afspraak voor een connectiviteitstest.

3.1.2 Opzetten connectiviteitstest XIS-typekwalificatie

Nictiz biedt twee verschillende kwalificatiesimulatoren aan. De meeste leveranciers maken van de kwalificatiesimulator via publiek internet gebruik en dat raden we voor de meeste gevallen ook aan.

Hierbij de gegevens van de kwalificatiesimulatoren:

1. Via publiek internet:

 Hierbij de gegevens van de kwalificatiesimulator (ART-DECOR):
 URL simulator (vanuit XIS-applicatie):  http(s)://kwalificatie.nictiz.nl/xis/<service locatie uit WSDL's>
 URL simulator (inloggen via browser): https://kwalificatie.nictiz.nl/art-decor
 Protocol: HTTP (poort 80) of HTTPS (poort 443)
 Certificaatboom certificaat van de simulator: DigiCert Global Root CA
 Certificaatboom certificaat van leveranciers-applicaties: UZI-test

2. Alleen bereikbaar op besloten netwerk zorgnet:

 Hierbij de gegevens van de kwalificatiesimulator (ART-DECOR):
 URL simulator (vanuit XIS-applicatie):  http(s)://nictiz.ks1.lsp.aorta-zorg.nl/xis/<service locatie uit WSDL's>
 URL simulator (inloggen via browser): https://nictiz.ks1.lsp.aorta-zorg.nl/art-decor
 Protocol: HTTP (poort 80) of HTTPS (poort 443)
 Certificaatboom certificaat van de simulator: UZI-test
 Certificaatboom certificaat van leveranciers-applicaties: UZI-test

Ter informatie: onze simulatoren ondersteunen Server Name Indication (SNI), een uitbreiding op het TLS protocol waarmee bij het opzetten van de verbinding door onze client wordt aangegeven welke server onze simulator naartoe wil verbinden. Dit maakt het mogelijk om bij de XIS-leverancier verschillende servercertificaten te stapelen op één omgeving (op dezelfde poort).

Ter informatie: Hierboven staan alleen de URLs van de kwalificatiesimulator genoemd, de IP-adressen voor ontvangen en verzenden zijn dezelfde. Dus er zijn geen afwijkende IP-adressen binnen de kwalificatiesimulator bij het zenden van berichten.

3.2 Berichten verzenden/ontvangen

Berichten die worden verzonden naar bovengenoemde URL’s worden gelogd op de kwalificatiesimulator. Vervolgens is het mogelijk om die te valideren.

3.3 Berichten uploaden

Merk op dat het ook mogelijk is om berichten te uploaden naar de omgeving. In de meeste gevallen is dat niet van toepassing want verwachten we dat berichten verzonden, of ontvangen worden vanuit de kwalificatiesimulator. Om berichten te uploaden: Kies naast 'Bericht laden' de button om een bericht te uploaden. (Na laden van een bericht verdwijnt de upload indicator niet. Er staat een rood kruisje naast, en wanneer u dat aanklikt herstelt de Upload button.) Voor het uploaden van xml-bestanden dienen bestanden de *.xml bestandsextensie te hebben. Na het laden van een bericht, toont het scherm de geladen berichten in de tab 'Bestanden'.

3.4 Validatie tegen informatiestandaarden

Één van de voordelen van het gebruik van de simulator is dat het schema- en schematron-validaties uitvoert op de verstuurde berichten, die door leveranciers zelf direct in te zien zijn. Hiermee kan de softwareleverancier controleren of de verstuurde inhoud voldoet aan de informatiestandaard. Merk op dat deze geautomatiseerde controles niet garanderen dat de inhoud volledig voldoet aan de informatiestandaard, maar dat er altijd controle door experts nodig is. De berichten moeten ten tijde van de kwalificatiesessie foutloos en liefst ook zonder opmerkingen door de controles gaan.

Valideren van al verzonden berichten/documenten kan via de volgende stappen:

  • In te loggen op de kwalificatiesimulator. Zie hiervoor de inloggegevens die worden verstuurd per email;
  • Navigeren naar de berichtenlog via: testen/berichten. Zie figuur 1;
  • Kies vervolgens onder Account in de drop-down uw eigen (bedrijfs-) testaccount.
  • Selecteren van het bericht/document triggert de validatie (als het bericht niet al gevalideerd is).

Figuur 1- Schermprint voor het navigeren naar de berichtenlog