Changelog¶

De voor Situatieberichten relevante delen van de conversietabel zoals beschikbaar op NDW docs zijn hieronder voor de volledigheid toegevoegd.

Enkele opmerkingen vooraf¶

Onderliggend aan deze mapping beschreven in dit document is voor versie 2.3 de NDW DATEX II v2.3 XSD. Voor versie 3 is gebruik gemaakt van een Europees XSD, dus zonder aangepaste enumeraties e.t.c., aangevuld met Nederlandse extensies. Waar in dit document 'versie 2.3' (of 'V2.3') wordt genoemd, wordt het Nederlands Profiel DATEX II bedoeld zoals beschreven in het Nederlands Profiel DATEX II 2015-2a (14 januari 2016).

Niet alle elementen uit het gebruikte versie 2.3 XSD worden naar versie 3 gemapt. De scope van de conversie zijn de elementen zoals beschreven in het document Nederlands Profiel DATEX II 2015-2a (14 januari 2016). Deze scope bevat minder elementen dan in het versie 2.3 XSD zijn opgenomen.

Op sommige plekken in dit document wordt daarom voor enumeraties de volledige lijst van literals uit de XSD's opgenomen en met een 'X' aangegeven welke er in het Nederlands Profiel versie 2.3 zijn opgenomen.

In DATEX II versie 3 wordt in tegenstelling tot DATEX II versie 2.3, gebruik gemaakt van meerdere namespaces. In deze documentatie zijn namespaces niet expliciet benoemd, omdat dit ten koste van de leesbaarheid van de tekst. Mocht bij de toepassing van deze documentatie in de praktijk blijken dat dit niet vermelden van namespaces een groot gemis is, dan zal uiteraard gekeken worden een praktische manier om deze informatie op te nemen.

Functionele eisen¶

• Het geconverteerde resultaat dient geen selfclosing tags te bevatten op plaatsen waar deze in de input niet aanwezig zijn.
• Als een xml-node meerdere keren voorkomt in de input, worden alle overeenkomstige xml-nodes in de output gegenereerd (itereren).

Generieke elementen¶

VehicleCharacteristics mapt naar VehicleCharacteristics¶

In versie 3 van het Europees DATEX II Model is het verplichte element typeOfWeight toegevoegd. Een mapper moet, als het verplichte element typeOfWeight in het versie 3 doelprofiel aanwezig is, dit vullen met 'actual'.

SituationPublication mapt naar SituationPublication¶

<payloadPublication xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="SituationPublication" lang="nl">
  <publicationTime>2022-11-22T17:07:41.507Z</publicationTime>
  <publicationCreator>
    <country>nl</country>
    <nationalIdentifier>NLNDW</nationalIdentifier>
  </publicationCreator>
  ... hier situation(s)...
</payloadPublication>

<payload xsi:type="sit:SituationPublication" lang="nl" modelBaseVersion="3">
  <com:publicationTime>2022-11-22T17:07:41.507Z</com:publicationTime>
  <com:publicationCreator>
    <com:country>nl</com:country>
    <com:nationalIdentifier>NLNDW</com:nationalIdentifier>
  </com:publicationCreator>
  ... hier situation(s)...
</payload>

Situation mapt naar Situation¶

<situation id="RWS01_SP448064_D2" version="18">
  <overallSeverity>medium</overallSeverity>
  <relatedSituation targetClass="Situation" id="RWS01_SM811801_D2" version="15"/>
  <situationVersionTime>2022-09-08T13:03:00Z</situationVersionTime>
  <headerInformation>
    <confidentiality>noRestriction</confidentiality>
    <informationStatus>real</informationStatus>
  </headerInformation>
    ... hier situationRecord(s)...
</situation>

<sit:situation id="RWS01_SM811801_D2">
  <sit:overallSeverity xmlns="http://datex2.eu/schema/3/situation">medium</sit:overallSeverity>
  <sit:situationVersionTime xmlns="http://datex2.eu/schema/3/situation">2022-11-16T09:12:10Z</sit:situationVersionTime>
  <sit:headerInformation xmlns="http://datex2.eu/schema/3/situation">
    <com:confidentiality>noRestriction</com:confidentiality>
    <com:informationStatus>real</com:informationStatus>
  </sit:headerInformation>
  ... hier situationRecord(s)...
  <sit:relatedSituation xmlns=“http://datex2.eu/schema/3/situation”>
    <sit:objectReference id=“RWS01_SP448064_D2” targetClass=“sit:Situation”/>
  </sit:relatedSituation>
</sit:situation>

SituationRecord (basistype) mapt naar SituationRecord (basistype)¶

Elementen¶

Onderstaande elementen dienen 1-op-1 te worden gemapt.

Source mapt naar Source¶

De structuur van de elementen-boom Source is analoog voor versie 2.3 en versie 3. Alle elementen dienen 1-op-1 te worden gemapt.

Validity mapt naar Validity¶

Noten:

• Het gebruik van recurringDayWeekMonthPeriod.applicableWeek is niet geconstateerd in NDW-datastroom sb-data in de periode van oktober 2018 t/m juli 2022. Mede hierom is de mapping van dit element (nog) niet beschreven. Is deze nodig, dan dient dat uiteraard alsnog toegevoegd te worden aan deze specificatie.
• In het Nederlands Profiel v2.3 staat de zinsnede: "Het gebruik van exceptionPeriod is ongewenst." Het gebruik van exceptionPeriod is niet aangetroffen in NDW-datastroom sb-data in de periode van oktober 2018 t/m juli 2022. Mede hierom is de mapping (nog) niet beschreven. Is deze nodig, dan dient dat uiteraard alsnog toegevoegd te worden aan deze specificatie.

Impact mapt naar Impact, SupplementaryPositionalDescription en TrafficElement¶

Klik hier voor meer context voor de mapping van Impact.originalNumberOfLanes naar versie 3 SupplementaryPositionalDescription.carriageway.originalNumberOfLanes.

Noten:

• Definities:
  • Versie 2.3 trafficConstrictionType = "The type of constriction to which traffic is subjected as a result of an event or operator action."
  • Versie 3 TrafficElement.trafficConstrictionType = "The type of constriction to which traffic is subjected as a result of an unplanned event"
• Definities:
  • Versie 2.3 originalNumberOfLanes = "The normal number of usable lanes in the specified direction that the carriageway has before reduction due to roadworks or traffic events."
  • Versie 3 SupplementaryPositionalDescription.Carriageway.originalNumberOfLanes = "Normal number of lanes, potentially available for moving traffic, before reduction due to situations. Hard shoulder should not be counted unless it is sometimes used operationally for moving traffic."

Cause mapt naar Cause¶

generalPublicComment mapt naar generalPublicComment¶

De structuur van de elementen-boom generalPublicComment is analoog voor versie 2.3 en versie 3. Alle elementen dienen 1-op-1 te worden gemapt.

UrlLink mapt naar UrlLink¶

De structuur van de elementen-boom UrlLink is analoog voor versie 2.3 en versie 3. Alle elementen dienen 1-op-1 te worden gemapt.

GroupOfLocations mapt naar LocationReference¶

NonRoadEventInformation (abstract) mapt naar ServiceInformation (abstract)¶

De abstracte klasse NonRoadEventInformation bevat geen (te mappen) elementen.

TransitInformation mapt naar TransitInformation¶

De elementen transitServiceInformation en transitServiceType mappen 1-op-1 van versie 2.3 naar versie 3.

RoadsideServiceDisruption mapt naar ServiceDisruption¶

Het versie 2.3 element roadsideServiceDisruptionType mapt naar het versie 3 element ServiceDisruptionType.

CarParks mapt naar ServiceDisruption¶

CarParks dient gemapt te worden naar ServiceInformation>ServiceDisruption met ServiceDisruptionType = noParkingAvailability.

Dit dient te gebeuren voor de enumeraties van CarParkStatusEnum zoals beschreven in onderstaande tabel. Het versie 2.3 element carParkIdentity wordt niet gemapt: dit heeft gezien de gevonden infomatieinhoud aangetroffen in dit veld weinig tot geen toegevoegde waarde.

TrafficElement (abstract) mapt naar TrafficElement (abstract)¶

Conditions mapt naar Conditions¶

Element drivingConditionType mapt 1-op-1 van versie 2.3 naar versie 3.

PoorEnvironmentConditions mapt naar PoorEnvironmentConditions¶

Element PoorEnvironmentType mapt 1-op-1 van versie 2.3 naar versie 3.

De elementen-boom Visibility mapt naar de elementen-boom Visibility.

RoadConditions (abstract) mapt naar RoadSurfaceConditions (abstract)¶

De abstracte klasse RoadConditions bevat geen (te mappen) elementen.

NonWeatherRelatedRoadConditions mapt naar NonWeatherRelatedRoadConditions¶

Element nonWeatherRelatedRoadConditionType mapt 1-op-1 van versie 2.3 naar versie 3.

WeatherRelatedRoadConditions mapt naar WeatherRelatedRoadConditions¶

De versie 2.3 waarden/enumeration literals van WeatherRelatedRoadConditionType/WeatherRelatedRoadConditionTypeEnum is/zijn op één na 1-op-1 te mappen naar de overeenkomstige versie 3 literals. De WeatherRelatedRoadConditionTypeEnum literal 'slipperyRoad' moet worden gehercodeerd naar 'slippery'.

AbnormalTraffic mapt naar AbnormalTraffic¶

De elementen abnormalTrafficType, queueLength, relativeTrafficFlow, trafficFlowCharacteristics en trafficTrendType mappen 1-op-1 van versie 2.3 naar versie 3.

EquipmentOrSystemFault mapt naar EquipmentOrSystemFault¶

De elementen equipmentOrSystemFaultType en faultyEquipmentOrSystemType mappen 1-op-1 van versie 2.3 naar versie 3.

Accident mapt naar Accident¶

accidentType mapt naar accidentType en collisionType¶

Obstruction (abstract) mapt naar Obstruction (abstract)¶

De abstracte klasse Obstruction bevat geen (te mappen) elementen.

mobilityOfObstruction¶

De versie 2.3 elementen-boom mobilityOfObstruction mapt naar de versie 3 elementen-boom mobilityOfObstruction.

AnimalPresenceObstruction mapt naar AnimalPresenceObstruction¶

De elementen alive en animalPresenceType mappen 1-op-1 van versie 2.3 naar versie 3.

EnvironmentalObstruction mapt naar EnvironmentalObstruction¶

Element environmentalObstructionType mapt 1-op-1 van versie 2.3 naar versie 3.

InfrastructureDamageObstruction mapt naar InfrastructureDamageObstruction¶

Element infrastructureDamageType mapt 1-op-1 van versie 2.3 naar versie 3.

GeneralObstruction mapt naar GeneralObstruction¶

Element ObstructionType dient gemapt te worden van versie 2.3 naar versie 3.

De versie 2.3 waarden/enumeration literals van obstructionType/ObstructionTypeEnum is/zijn over het grootste deel 1-op-1 te mappen naar de overeenkomstige versie 3 literals.

De ObstructionTypeEnum literals highSpeedChase, houseFire en recklessDriver (allemaal opgenomen in Nederlands Profiel versie 2.3), bestaan niet meer in versie 3 en dienen gemapt te worden naar 'other'. Deze drie literals zijn overigens niet teruggevonden in NDW-datastroom sb-data in de periode van oktober 2018 t/m juli 2022.

VehicleObstruction mapt naar VehicleObstruction¶

Element vehicleObstructionType dient gemapt te worden van versie 2.3 naar versie 3. Voor de mapping van de enumeration literals in een conversietabel beschikbaar.

vehicleObstructionType mapt naar vehicleObstructionType¶

Activity (abstract) mapt naar Activity (abstract)¶

De abstracte klasse Activity bevat geen (te mappen) elementen.

AuthorityOperation mapt naar AuthorityOperation¶

Element authorityOperationType mapt 1-op-1 van versie 2.3 naar versie 3.

PublicEvent mapt naar PublicEvent¶

Element publicEventType mapt 1-op-1 van versie 2.3 naar versie 3.

DisturbanceActivity¶

Element disturbanceActivityType mapt 1-op-1 van versie 2.3 naar versie 3.

OperatorAction (abstract) mapt naar OperatorAction (abstract)¶

Element operatorActionStatus mapt 1-op-1 van versie 2.3 naar versie 3.

RoadsideAssistance mapt naar RoadsideAssistance¶

Element roadsideAssistanceType mapt 1-op-1 van versie 2.3 naar versie 3.

NetworkManagement (abstract) mapt naar NetworkManagement (abstract)¶

De elementen applicableForTrafficDirection en complianceOption mappen 1-op-1 van versie 2.3 naar versie 3.

De elementen-boom forVehiclesWithCharateristicsOf mapt naar de elementen-boom forVehiclesWithCharateristicsOf.

ReroutingManagement mapt naar ReroutingManagement¶

De elementen reroutingManagementType, reroutingItineraryDescription en signedRerouting mappen 1-op-1 van versie 2.3 naar versie 3.

De elementen-boom alternativeRoute mapt naar de elementen-boom alternativeRoute.

SpeedManagement mapt naar SpeedManagement¶

De elementen speedManagementType en temporarySpeedLimit mappen 1-op-1 van versie 2.3 naar versie 3.

RoadOrCarriagewayOrLaneManagement mapt naar RoadOrCarriagewayOrLaneManagement¶

Element roadOrCarriagewayOrLaneManagementType mapt 1-op-1 van versie 2.3 naar versie 3.

GeneralInstructionOrMessageToRoadUsers mapt naar GeneralInstructionOrMessageToRoadUsers¶

De elementen generalInstructionToRoadUsersType en generalMessageToRoadUsers mappen 1-op-1 van versie 2.3 naar versie 3.

GeneralNetworkManagement mapt naar GeneralNetworkManagement¶

De elementen generalNetworkManagementType en trafficManuallyDirectedBy mappen 1-op-1 van versie 2.3 naar versie 3.

RoadWorks (abstract) mapt naar RoadWorks (abstract)¶

Subjects mapt naar Subjects¶

In het Nederlands Profiel versie 2.3 is de subjectsExtension.subjectTypeOfWorksExtension beschikbaar om extra enumeration literals voor subjectTypeOfWorks beschikbaar te maken. In versie 3 zijn alle enumeratation literals van versie 2.3 SubjectTypeOfWorksExtensionEnum beschikbaar gekomen in het DATEX II Europees DATEX II Model. Dus in versie 3 is een extensie niet meer nodig. De mapping is als volgt:

• Subjects.subjectTypeOfWorks mapt naar Subjects.subjectTypeOfWorks
• Subjects.SubjectsExtension.SubjectTypeOfWorksExtension.subjectTypeOfWorksExtension mapt naar Subjects.subjectTypeOfWorks

Een overzicht hoe de enumeration literals van versie 2.3 SubjectTypeOfWorksEnum en versie 2.3 SubjectTypeOfWorksExtensionEnum moeten worden gehercodeerd en gemapt naar de versie 3 enumeration literals van versie 3 SubjectTypeOfWorksEnum is hieronder weergegeven.

ConstructionWorks mapt naar ConstructionWorks¶

Element constructionWorkType mapt 1-op-1 van versie 2.3 naar versie 3.

MaintenanceWorks mapt naar MaintenanceWorks¶

Element roadMaintenanceType mapt 1-op-1 van versie 2.3 naar versie 3.