Nictiz XML-distributie Ambulance v2.4.0-patch1

Gegenereerd: 22 March 2021, patch 1 dd 1 Juni 2021

Welkom bij de HTML-documentatie van de XML-distributie.

Release: V2.4.0-patch1, Ambulanceoverdracht SEH; Retourbericht SEH naar Ambulance

Technische aanpassing in schematronbestanden DTr1_hl7nl-IVL_TS.sch, DTr1_IVL_TS.sch, 2.16.840.1.113883.2.4.3.11.60.55.10.1112-2016-11-14T151650.sch, en 2.16.840.1.113883.2.4.3.11.60.55.10.1113-2016-11-14T153341.sch waardoor variabele-namen niet worden hergebruikt in dezelfde scope. Dit vergroot compatibiliteit met sommige frameworks zoals .Net. De SVRL en TXT versies van de schematrons zijn opnieuw gegenereerd met deze aanpassingen.

Deze publicatie vervangt de vorige release V2.3.

De release notes zijn onderverdeeld in:

  • Scenario ‘AMB draagt over aan SEH’ (richtlijn berichten 8, 9 en 10);
  • Scenario ‘SEH rapporteert terug aan AMB organisatie’ (richtlijn bericht 12)
  • Uitgevoerd onderhoud na v2.3

Scenario ‘AMB draagt over aan SEH’

Ambulancezorg Nederland (AZN) heeft het scenario ‘AMB draagt over aan SEH’ onderzocht op toepasbaarheid in de huidige praktijk. De resultaten hiervan zijn wijzigingsvoorstellen in kardinaliteiten, condities bij conditionele velden, waardelijsten, elementnamen en de aanvraag van een aantal nieuwe velden. Verder heeft Nictiz inconsistenties tussen het scenario en de templates geconstateerd.

De doorgevoerde wijzigingen:

  • In het scenario zijn de volgende kardinaliteiten gewijzigd:
    • Mechanisme – Mechanisme type van 0..1 R naar 0..* R
    • Primary Survey – Breathing – observaties van 0..1 R naar 0..* R
    • Primary Survey – Circulation – Huid observatie van 0..1 R naar 0..* R
    • Primary Survey – Disability – Intoxicatie van 0..1 R naar 0..* R
    • Secondary Survey – Verloskunde – Vruchtwaterverlies van 0..* R naar 0..1 C (alleen als observatie = lekken van vruchtwater)
    • Toestemmingsgegevens - Wetenschappelijk onderzoek van 0..1 R naar 0..* R
    • Toestemmingsgegevens - Wetenschappelijk onderzoek – ‘beschrijving’ en ‘informed consent’ beide van 0..1 R naar 1..1 M.
  • Condities (in vrije tekst), die waren geformuleerd op basis van verouderde waardelijsten, zijn bijgewerkt, en zijn bij de template definities op verschillende plekken verplaatst uit de omschrijving naar het officiële conditieveld. Vruchtwater­verlies is conditioneel gemaakt: zie het overzicht hierboven.
  • Elementnamen gewijzigd:
    • ‘BOPZ maatregel’ is nu ‘Wzd/Wvggz maatregel’
    • ‘Afspraken met consultgever’ is nu ‘Toelichting/Afspraken met consultgever’
  • Waardelijsten aangepast:
    • Wzd/Wvggz Maatregelen – 2 gewijzigde (002, 003) en 2 toegevoegde codes (004, 005)
    • Patiënt vervoerd, soort vervoer – 011 verwijderd, 012 naamswijziging
    • Reden geen patiënt vervoerd – 112 naamswijziging, 113 toegevoegd
    • Hulpverleners ter plaatse – 2 nieuwe codes (015, 016)
    • Medicatieoverzicht – 4 nieuwe codes (13.29 – 13.32)
    • Consultgever op afstand – 009 toegevoegd
    • Bijlagen – 005 en 009 naamswijziging
  • Nieuwe elementen toegevoegd
    • Meldingsgegevens - Tijdstip aanvang TVZ
    • Bestemmingsgegevens – Bestemmingsstatus. Met status geannuleerd wordt de ontvanger op de hoogte gesteld dat de patiënt niet langer naar hen toe komt. Overige berichtinhoud dan minimaal. Hiervoor is ook een nieuwe waardelijst aangemaakt: Bestemmingsstatussen.
    • Meetwaarden: Tijdstip toegevoegd bij: RTS, PTS, Pijnschaal
    • Primary Survey - Mogelijk trombolyse/trombectomie? (J/N)
    • Secondary Survey – Extremiteiten Armen en -Benen: structuur aangepast zodat er voor links en rechts (nieuw element: Lateraliteit) apart observaties en wonden kunnen worden geregistreerd. Hiervoor is ook een nieuwe waardelijst aangemaakt: LateraliteitCodelijst.

Scenario ‘SEH rapporteert terug aan AMB’

Door nieuwe wettelijke vereisten uit de Algemene Maatregel van Bestuur (kenmerk 1779288-210008-WJZ / advies W13.20.0342/III, december 2020) moet het scenario ‘SEH rapporteert terug aan AMB’ worden aangepast. De AMvB streeft data-minimalisatie na.

De doorgevoerde wijzigingen:

  • Nieuw element toegevoegd:
    • Werkdiagnose Akkoord?
  • Elementen toegevoegd aan scenario:
    • Persoonsgegevens - Geslacht
    • Persoonsgegevens - Geboortedatum
  • Condities:
    • Diagnosegegevens zijn conditioneel. Als de ‘werkdiagnose Akkoord?’ waar is (d.w.z. de SEH diagnose komt overeen met de Ambulance werkdiagnose), dan worden er geen diagnose details in het bericht opgenomen (kardinaliteit: 0..* Conditioneel).
    • Persoonsidentificatie is conditioneel. Deze wordt alleen opgenomen als de patiëntidentificatie naar de ambulancedienst wordt gestuurd. In andere situaties wordt deze niet teruggestuurd, omdat de patiëntidentificatie al bekend is.

Uitgevoerd onderhoud na v2.3

Naast de bovenstaande wijzigingen is onderhoud uitgevoerd op de volgende issues die na de publicatie van de 2.3 release zijn gemeld. Bij het issue staat een beschrijving van de oplossing gegeven:

  • Issue 285 "Attachment creatie datum toevoegen" met status "Gesloten". Laatste gebeurtenis (2020-11-19T10:07:07):

Veld is toegevoegd aan Attachment Media waarin de creatiedatum van het attachment vastgelegd kan worden.

  • Issue 286 "verkeerde kardinaliteit effectiveTime" met status "Gesloten". Laatste gebeurtenis (2021-01-07T13:09:57):

Ritgegevens - EffectiveTime kardinaliteit is aangepast naar 0..1 R, zoals de scenario's specificeren. (I.h.b. voor het bevestiging bericht.)

  • Issue 287 "consistente naamgeving doorvoeren" met status "Gesloten". Laatste gebeurtenis (2021-01-21T14:16:15):

Alle scenario's, transacties, templates, voorbeeldberichten en schematrons hebben nu een consistente naam volgens de volgende opzet:

  • Voor scenarios: <Zender> <Berichttype als werkwoord> naar/aan <Ontvanger> (voorbeeld: AMB draagt over aan SEH)
  • Voor de transacties, templates en andere materialen: <Berichttype als zelfstandig naamwoord> <Zender> naar/aan <Ontvanger> (voorbeeld: Sturen overdracht AMB aan SEH)
  • Issue 288 "Code ontslagdiagnose mist terminologiekoppeling" met status "Gesloten". Laatste gebeurtenis (2021-02-05T10:14:54):

De dataset Code Ontslagdiagnose is nu gekoppeld aan de waardelijst ProbleemNaamCodelijst, met de opmerking in de beschrijving dat hier alleen ICD-10 en SNOMED gebruikt worden.

Het template was al gekoppeld aan deze waardelijst. In het bericht Terugrapportage SEH aan AMB is een zelfde opmerking toegevoegd bij de inclusie van de generieke template Problem Observation Section.

  • Issue 291 "Problem Obs. Section code gelijktrekken met BGZ" met status "Gesloten". Laatste gebeurtenis (2021-02-25T10:20:19):

Code van het template 'Problem Observation Section (2.16.840.1.113883.2.4.3.11.60.55.10.9018) is gelijkgetrokken met het vergelijkbare BGZ template BgZ2017 Klachten en diagnoses , naar <hl7:code code="11450-4" displayName="Problem list Reported" codeSystem="2.16.840.1.113883.6.1" codeSystemName="LOINC"/>

Wrappers

De berichten van beide scenario’s worden uitgewisseld over het LSDV van AZN. De daarvoor benodigde wrappers zijn onder beheer van AZN. Neem hiervoor contact op met AZN. Nictiz is niet verantwoordelijk of benaderbaar voor support van de wrappers.

Tips bij het gebruik:

  • Bij tabellen kan de inhoud naar wens gesorteerd worden door op één van de kolombeschrijvingen te klikken, het kleine rode pijltje geeft aan hoe gesorteerd wordt.
  • De Webservices tab is meer dan alleen een opsomming van alle webservices, het is ook een handige ingang naar achterliggende XML schema's en XML-voorbeeldberichten.

Nictiz is voor nieuwere projecten/standaarden overgeschakeld naar een nieuwe methodiek DECOR. Nictiz onderhoudt op basis hiervan alle huidige en toekomstige materialen op een openbaar toegankelijke server decor.nictiz.nl/art-decor. De doelen en de achtergrond van deze open source methodiek, vindt u hier:

Deze omschakeling betekent voor de XML schema's en webservices nog niets, maar HL7v3-interacties zullen vaker gebruik maken van templateId's en schematronbestanden en vocabulaire zullen anders van opbouw zijn. Standaarden gebaseerd op DECOR hebben volledig gegenereerde schematrons en vocabulairebestanden.

Hieronder een overzicht van alle Webservices (met link naar de documentatie) met hun WSDL. In alle gevallen is de WSDL de normatieve beschrijving van de Webservice en is de documentatie aanvullend. De derde kolom toont de interactieschema's van de berichten die in de webservice gebruikt worden.
Naam Omschrijving
Webservices GBZ Indexbestand voor webservices ten behoeve van een Goed Beheerd Zorgsysteem (GBZ)
Hieronder een overzicht van alle 23 XML schema's, waarvan 2 interacties. De schema's zijn per HL7-domein, zichtbaar in de eerste vier letters, gegroepeerd en worden voorafgegaan door het overzicht van interacties. De interacties komen ook terug in de HL7-domeingroepen.

Interacties

XML Schema Omschrijving Includes Interactie
MCCI_IN000002.xsd Interactieschema: Ontvangstbevestiging
POCD_IN000040NL.xsd Interactieschema: Versturen ClinicalDocument

CDA

XML Schema Omschrijving Includes Interactie
CDANL_extended.xsd
CDA top level schema met Nederlandse extensies
CDAr2ClinicalStatement.xsd
XML Schema met complexTypes voor het officiële CDA ClinicalStatement, met enkele uitzonderingen. Zie interne schema-documentatie voor details.
hl7nl_extension.xsd
XML Schema met Nederlandse extensies voor CDA.
organizer.xsd
XML Schema met organizer die bouwstenen groepeert op basis van CDAr2ClinicalStatement.xsd
POCD_MT000040NL_extended.xsd
CDA include level schema met Nederlandse extensies
sdtc_extension.xsd
XML Schema met HL7 Structured Documents Technical Committee (SDTC) extensies voor CDA.

COCT - Common Message Elements

lab

XML Schema Omschrijving Includes Interactie
lab_extension.xsd
XML Schema met Nederlandse extensies voor Laboratoria.

MCAI - Message Act Infrastructure

MCCI - Message Control Infrastructure

pharm

XML Schema Omschrijving Includes Interactie
pharm_extension.xsd
XML Schema met Nederlandse extensies voor Pharmacy/medicatie.

POCD

XML Schema Omschrijving Includes Interactie
POCD_IN000040NL.xsd Interactieschema: Versturen ClinicalDocument
Hieronder een overzicht van alle Schematrons. Schematronbestanden van het type "interactie-id.sch" horen bij de oorspronkelijke methodiek. Schematronbestanden van het type "prefix-omschrijving.sch" zijn gegenereerd uit een DECOR-definitie.
Map/bestand Omschrijving
acutezorg-instance2schematron.xml Bestand dat verbinding maakt tussen een instance en een schematronbestand en tussen een template en een transactie
acutezorg-Overdracht_AMB_SEH.sch Schematron file for transaction Sturen overdracht AMB aan SEH (2.16.840.1.113883.2.4.3.11.60.55.4.23 2015-11-05T14:53:34)
acutezorg-Terugrapportage_SEH_AMB.sch Schematron file for transaction Sturen terugrapportage SEH aan AMB (2.16.840.1.113883.2.4.3.11.60.55.4.26 2016-07-12T15:02:14)
include Map met basis-schematron- en vocabulairebestanden voor alle via de DECOR-methodiek gegenereerde schematron
Overzicht van de binnen de map vocab gebruikte vocabulaires. De via de DECOR-methodiek (zie tabblad Inleiding) gegenereerde vocabulairebestanden staan in schematron/include en zijn niet hier gedocumenteerd, maar in de betreffende projectdocumentatie. Naarmate meer projecten worden ge/herschreven in DECOR zal het aantal hier genoemde vocabulaires afnemen. Het overzicht van door Nictiz gedefinieerde vocabulaire in ART-DECOR vindt u hier: http://decor.nictiz.nl/decor/services/ValueSetIndex?prefix=acutezorg-&version=2021-03-18T08:54:22

N.B. Vocabulaires die niet door Nictiz worden beheerd zijn zuiver informatief. Zij zijn opgenomen voor gebruik door de schematron en html presentatie stylesheets, meldingen moeten gezien worden waarschuwingen.

Naam OID
Trigger event 2.16.840.1.113883.1.18
Interactie Id 2.16.840.1.113883.1.6
Het onderstaande overzicht bevat beschrijvingen van de mappen in de XML-distributie. Klikken op een map gaat rechtstreeks naar de desbetreffende map.
Map/bestand Omschrijving
coreschemas
XML-basisschema's voor de definitie van datatypen en vocabulaires.
css
Bestanden voor de opmaak van html pagina's. Deze worden gebruikt voor de opmaak van de html documentatie en ook voor de opmaak van de html weergave van xml berichten. Naast cascading style sheets (css) bestanden voor de opmaak bevat deze folder ook javascript bestanden.
schemas
XML schema's voor de definitie van XML berichten. De XML schema's definiëren de structuur van de berichtinhoud en veelal ook de cardinaliteit van de elementen in een bericht.
schemas_codeGen
XML schema's welke door transformatie geschikt zijn gemaakt voor generatie van code door de transmission wrapper en de control act wrapper in het interactieschema te trekken. Hierdoor zijn er geen dubbele declaraties van Message, ControlAct, QueryByParameterPayload en Payload meer bij het genereren van code uit bijvoorbeeld de WSDL. Deze schema's zijn functioneel gelijk aan de schema's in de schemas folder.
schemas_codeGen_flat
XML schema's welke door transformatie volledig op zichzelf staan en geen verwijzingen meer naar andere schema's hebben (afgezien van eventuele xs:import). Deze schema's zijn functioneel gelijk aan de schema's in de schemas folder.
schematron
Schematron-bestanden voor de validatie van 'business rules'. Het gaat hierbij om eisen die in implementatiehandleidingen zijn opgenomen, maar slechts moeizaam of helemaal niet met XML schema zijn af te dwingen. Dit is relevant voor ontwikkeling / test fase en niet bedoeld voor een productieomgeving.
schematron_closed_warnings
De map 'schematron_closed_warnings' bevat schematrons met daarin naast de gebruikelijke meldingen ook waarschuwingen worden gegeven voor zaken die niet zijn gespecificeerd. Dit is relevant voor ontwikkeling / test fase en niet bedoeld voor een productieomgeving.
schematron_closed_warnings_svrl
XSLT (stylesheets) bestanden welke gegenereerd zijn uit de schematronbestanden in schematron_closed_warnings. Indien de mogelijkheid ontbreekt om Schematron-bestanden te gebruiken voor de validatie van XML berichten dan kunnen deze XSLT's gebruikt worden. SVRL staat voor Schematron Validation Reporting Language (zie: http://schematron.com) en geeft de meldingen terug in een XML-structuur zodat deze verder kunnen worden verwerkt in andere logica.
schematron_closed_warnings_xslt
XSLT (stylesheets) bestanden welke gegenereerd zijn uit de schematronbestanden. Indien de mogelijkheid ontbreekt om Schematron-bestanden te gebruiken voor de validatie van XML berichten dan kunnen deze XSLT's gebruikt worden. Deze XSLT's geven de meldingen terug via xsl:message. Deze meldingen zijn geschikt voor afslag in bijvoorbeeld logging. Zie SVRL om meldingen in een verwerkbare vorm geleverd te krijgen. (http://schematron.com)
schematron_svrl
XSLT (stylesheets) bestanden welke gegenereerd zijn uit de schematronbestanden. Indien de mogelijkheid ontbreekt om Schematron-bestanden te gebruiken voor de validatie van XML berichten dan kunnen deze XSLT's gebruikt worden. SVRL staat voor Schematron Validation Reporting Language (zie: http://schematron.com) en geeft de meldingen terug in een XML-structuur zodat deze verder kunnen worden verwerkt in andere logica.
schematron_xslt
XSLT (stylesheets) bestanden welke gegenereerd zijn uit de schematronbestanden. Indien de mogelijkheid ontbreekt om Schematron-bestanden te gebruiken voor de validatie van XML berichten dan kunnen deze XSLT's gebruikt worden. Deze XSLT's geven de meldingen terug via xsl:message. Deze meldingen zijn geschikt voor afslag in bijvoorbeeld logging. Zie SVRL om meldingen in een verwerkbare vorm geleverd te krijgen. (http://schematron.com)
vocab
Vocabulaire bestanden met, binnen AORTA gebruikte, vocabulaires. Deze bestanden hebben als naam de OID van het desbetreffende vocabulaire met als extensie .xml.

N.B. Vocabulaires die door derden worden beheerd zijn zuiver informatief. Zij zijn opgenomen voor gebruik door de schematron en html presentatie stylesheets, meldingen moeten gezien worden waarschuwingen.

wsdl
WSDL-bestanden met definities van de webservices.
xml-acutezorg
XML-voorbeeldberichten uit het domein Acute Zorg.