Nictiz XML-distributie Ambulanceoverdracht SEH v2.2

Gegenereerd: 15 mei 2019

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

Release: V2.2

In deze release zijn in overleg met deelnemende partijen wijzigingen doorgevoerd in diverse secties, waaronder Ritgegevens, Bestemmingsgegevens en Bijlagen. Verder zijn er diverse consistentieslagen gemaakt in het CDA-document in relatie tot de triageverwijsberichten.
 
In de XML-materialen onder deze release treft u nu ook een definitie voor een webservice aan (WSDL). Het CDA-document kan via deze webservice worden aangeboden bij een ontvanger. Deze definitie is tot stand gekomen op basis van behoefte bij implementerende partijen. De WSDL is gemodelleerd naar voorbeeld webservices op het Landelijk Schakelpunt (LSP). Deze specificatie richt zich op de inhoud van de uitwisseling. De WSDL wordt bijgeleverd voor infrastructuren die deze willen gebruiken. Het is geen normatieve oplossing voor iedere infrastructuur.
 
Er zijn wijzigingen geweest in de volgende issues sinds de laatste tussentijdse versie of release.
  • Issue 222 "OID van ritnummer ontbreekt" met status "Gesloten". Laatste gebeurtenis (2019-04-10T15:43:38):
    De OID 2.16.840.1.113883.2.4.3.32.5 van ritnummer is toegevoegd.
  • Issue 223 "OID voor ambulancenummer" met status "Gesloten". Laatste gebeurtenis (2019-04-09T18:39:46):
    De OID is gedeclareerd in de sectie ids, is via een identificatiekoppeling aan het dataset concept gekoppeld en is toegepast in de template AmbulanceTrip
  • Issue 226 "Ritnummer en ritvolgnummer horen in act/id" met status "Gesloten". Laatste gebeurtenis (2019-04-10T15:46:16):
    Het ritnummer nu een identificatie. Het bestaat uit aantal onderdelen die worden gescheiden door een koppelteken "-". De structuur is [ambulancevoorziening-jaartal-ritvolgnummer-patiëntvolgnummer]. Een voorbeeld van een ritnummer is: 05-2019-10-1
    • ambulancevoorziening N1..2 - Identificatienummer van de ambulancevoorziening
    • jaartal N4
    • ritvolgnummer N1..7 - Volgnummer van de rit, uniek binnen de ambulancevoorziening en het jaartal
    • patiëntvolgnummer N1 - Volgnummer van de patiënt binnen de rit. Dit is alleen hoger dan 1 als er meerdere patiënten vervoerd worden.
  • Issue 227 "Duiding nodig voor elkaar opvolgende documenten" met status "Gesloten". Laatste gebeurtenis (2019-04-12T09:23:50):
    In het document voor Ambulance SEH zijn de inline templates vervangen door dezelfde inclusies van setId en versionNumber als in de overige documenten. De documentatie op deze inclusies is uitgebreid met duiding over versionering van documenten, zoals voorgesteld.
  • Issue 229 "Identificatie van bijlagen essentieel" met status "Gesloten". Laatste gebeurtenis (2019-04-10T15:50:12):
    Het concept bijlagen heeft de volgende eigenschappen gekregen:
    • Type Bijlage
    • Bijlage id
    • Versie
    • Bijlageset id
  • Issue 232 "Alle secties hebben de verkeerde cardinaliteit" met status "Gesloten". Laatste gebeurtenis (2019-04-12T09:42:55):
    Aangepast conform transactie

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:

pharm

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

MCCI - Message Control Infrastructure

COCT - Common Message Elements

XML Schema Omschrijving Includes Interactie
COCT_MT030203.xsd E_Person contact: 16 Mar 2004 CMET used to specify enough information to contact a particular person. The person would only be contacted through a role, hence the contact information would be contained in the played/scoped role.
COCT_MT040203.xsd R_NotificationParty Contactible: 16 Mar 2004 Identifies a party (person or organization) acting as a contact party on behalf of a person or organization (scoper).
COCT_MT070000.xsd R_LocationLocatedEntity universal: 15 Mar 2004 CMET used to identify the physical presence of an entity (e.g. location of a device). Allows for nested-definitions of locations (e.g. place within a place within a place).
COCT_MT090100.xsd R_AssignedPersonNL universal: 26/12/2004 Nederlandse variant van R_AssignedPerson, waarbij sprake is van een persoon (de player) die een rol vervult namens een Organisatie (de scoper)
COCT_MT090300.xsd R_AssignedDevice universal: 16 Mar 2004 Supports messages related to an assigned provider, as a device. An assigned role is one in which the agent is an Entity acting in the employ of an organization. The focus is on functional role on behalf of the organization,
COCT_MT150000.xsd E_Organization universal: 15 Mar 2004. Specification of information to identifiy an organization, including the ability to contact a person acting as a liason in their specific role as contact in that organization. Organizational hierarchies can also be expressed.
COCT_MT150003.xsd E_Organization contact: 16 Mar 2004 Specification of information to contact an organization
COCT_MT230100UV_ext_pharmacy.xsd
COCT_MT440001UV_ext_pharmacy.xsd
COCT_MT710000.xsd E_Place universal: 15 Mar 2004 A place optionally within a hierarchy of places or optionally containing a hierarchy of places, e.g., a bed within a room, or a wing containing many rooms.

MCAI - Message Act Infrastructure

POCD

XML Schema Omschrijving Includes Interactie
POCD_IN000040NL.xsd Interactieschema:

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.

lab

XML Schema Omschrijving Includes Interactie
lab_extension.xsd
XML Schema met Nederlandse extensies voor Laboratoria.
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-cda-amb-seh.sch Schematron file for transaction Sturen Ambulanceoverdracht SEH (2.16.840.1.113883.2.4.3.11.60.55.4.23 2015-11-05T14:53:34)
acutezorg-instance2schematron.xml Bestand dat verbinding maakt tussen een instance en een schematronbestand en tussen een template en een transactie
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=2019-04-18T17:53:10

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.