Changelog¶
Conversietabel v2 -> v3¶
De voor VMS 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).
VmsTablePublication mapt naar VmsTablePublication voor DRIPS¶
- In tegenstelling tot de functionele eisen zoals vermeld in het begin van dit document, is het toegestaan om de selfclosing-tag voor het element vmsConfiguration op te nemen als voor deze versie 3 elementen-boom in de versie 2.3 input geen informatie aanwezig is. Deze uitzondering wordt toegestaan, omdat het element vmsConfiguration verplicht opgenomen moet worden in versie 3.
- Zowel in een versie 2.3 snapshot van NDW Open Data van 15 maaart 2023 als 18 april 2023 komt de elementen-boom vmsRecord.vmsPictogramDisplayCharacteristics niet voor. Deze elementen zijn daarom (nog) niet gemapt naar versie 3.
- Bovenstaande geldt ook voor de elementen-boom vmsRecord.vmsManagedLogicalLocation.
| In NL Profiel v2.3? | Was payloadPublication xsi:type="VmsTablePublication" (V2.3) |
Wordt payload xsi:type="vms:VmsTablePublication" (V3) |
Opmerking |
|---|---|---|---|
| X | lang | lang | |
| modelBaseVersion | Dit verplichte element voor versie 3 vullen met de waarde 3 | ||
| X | publicationTime | publicationTime | |
| X | publicationCreator | publicationCreator | |
| X | publicationCreator.country | publicationCreator.country | |
| X | publicationCreator.nationalIdentifier | publicationCreator.nationalIdentifier | |
| X | headerInformation.confidentiality | headerInformation.confidentiality | |
| X | headerInformation.informationStatus | headerInformation.informationStatus | |
| X | vmsUnitTable | vmsControllerTable | |
| X | vmsUnitTable.id | vmsControllerTable.id | |
| X | vmsUnitTable.version | vmsControllerTable.version | |
| X | ---.VmsUnitRecord | ---.vmsController | |
| X | ---.VmsUnitRecord.id | ---.vmsController.id | |
| X | ---.VmsUnitRecord.version | ---.vmsController.version | |
| X | ---.VmsUnitRecord.numberOfVms | ---.vmsController.numberOfVms | |
| X | ---.VmsUnitRecord.vmsRecord | ---.vmsController.vms | |
| X | ---.---.vmsRecord.vmsIndex | ---.---.vms.vmsIndex | |
| ---.---.---.vmsRecord | ---.---.---.vms | ||
| X | ---.---.---.vmsRecord.vmsDescription | ---.---.---.vms.description | |
| X | ---.---.---.vmsRecord.vmsPhysicalMounting | ---.---.---.vms.physicalSupport | |
| X | ---.---.---.vmsRecord.vmsType | ---.---.---.vms.vmsType | |
| ---.---.---.vms.vmsConfiguration | Nieuw in versie 3 selfclosing-tag is voor dit element toegestaan als er geen onderliggende informatie uit versie 2.3 beschikbaar is. |
||
| ---.---.---.---.---.DisplayArea | Nieuw in versie 3 | ||
| ---.---.---.---.---.DisplayArea.displayAreaIndex | Nieuw in versie 3, vul dit element met de waarde 1 | ||
| X | ---.---.---.vmsRecord.vmsTextDisplayCharacteristics | ---.---.---.---.---.DisplayArea xsi:type="TextDisplayArea" | In versie 3 wordt in tegenstelling tot versie 2.3 gewerkt met specialisaties. |
| X | ---.---.---.---.textDisplayHeight | ---.---.---.---.---.---.displayGeometry.displayHeight | Element niet gevonden in snapshot Nederlandse data |
| X | ---.---.---.---.textDisplayWidth | ---.---.---.---.---.---.displayGeometry.displayWidth | Element niet gevonden in snapshot Nederlandse data |
| X | ---.---.---.---.maxNumberOfCharacters | ---.---.---.---.---.---.maxNumberOfCharacters | Element niet gevonden in snapshot Nederlandse data |
| X | ---.---.---.---.maxNumberOfRows | ---.---.---.---.---.---.maxNumberOfRows | |
| X | ---.---.---.vmsRecord.vmsPictogramDisplayCharacteristics | (Nog) niet gemapt | Element niet gevonden in snapshot Nederlandse data |
| X | ---.---.---.vmsRecord.vmsPictogramDisplayCharacteristics.pictogramDisplayAreaIndex | (Nog) niet gemapt | Element niet gevonden in snapshot Nederlandse data |
| X | ---.---.---.---.pictogramLanternsPresent | (Nog) niet gemapt | Element niet gevonden in snapshot Nederlandse data |
| X | ---.---.---.---.pictogramCodeListIdentifier | (Nog) niet gemapt | Element niet gevonden in snapshot Nederlandse data |
| X | ---.---.---.vmsRecord.vmsLocation xsi:type="Point" | ---.---.---.vmsRecord.vmsLocation xsi:type="PointLocation" | Conform hier beschreven mapping |
| X | ---.---.---.vmsRecord.vmsManagedLogicalLocation | (Nog) niet gemapt | Element niet gevonden in snapshot Nederlandse data |
| X | ---.---.---.---.ManagedLogicalLocation | (Nog) niet gemapt | Element niet gevonden in snapshot Nederlandse data |
VmsPublication mapt naar VmsPublication voor DRIPS¶
- Elementen van de elementen-boom vmsPictogramDisplayArea worden (nog) niet gemapt. In de data is het gebruik ervan namelijk niet aangetroffen. En wordt er een binary image opgenomen.
| In NL Profiel v2.3? | Was payloadPublication xsi:type="VmsPublication" (V2.3) |
Wordt payload xsi:type="vms:VmsPublication" (V3) |
Opmerking |
|---|---|---|---|
| X | lang | lang | |
| modelBaseVersion | Dit verplichte element voor versie 3 vullen met de waarde 3 | ||
| X | publicationTime | publicationTime | |
| X | publicationCreator | publicationCreator | |
| X | publicationCreator.country | publicationCreator.country | |
| X | publicationCreator.nationalIdentifier | publicationCreator.nationalIdentifier | |
| X | headerInformation.confidentiality | headerInformation.confidentiality | |
| X | headerInformation.informationStatus | headerInformation.informationStatus | |
| X | vmsUnit | VmsControllerStatus | |
| X | ---.vmsUnitTableReference | ---.vmsControllerTableReference | |
| X | ---.vmsUnitTableReference.id | ---.vmsControllerTableReference.id | |
| X | ---.vmsUnitTableReference.version | ---.vmsControllerTableReference.version | |
| X | ---.vmsUnitTableReference.targetClass | ---.vmsControllerTableReference.targetClass | In versie 3 deze targetClass vullen met "vms:VmsControllerTable" |
| X | ---.vmsUnitReference | ---.vmsControllerReference | |
| X | ---.vmsUnitReference.id | ---.vmsControllerReference.id | |
| X | ---.vmsUnitReference.version | ---.vmsControllerReference.version | |
| X | ---.vmsUnitReference.targetClass | ---.vmsControllerReference.targetClass | In versie 3 deze targetClass vullen met "vms:VmsController" |
| X | ---.vms | ---.vmsStatus | |
| X | ---.vms.vmsIndex | ---.vmsStatus.vmsIndex | |
| X | ---.---.vms | ---.---.vmsStatus | |
| X | ---.---.---.vmsWorking | ---.---.---.workingStatus | Als vmsWorking=true, dan workingStatus=working Als vmsWorking=false, dan workingStatus=notWorking |
| X | ---.---.---.vmsMessage | ---.---.---.vmsMessage | |
| X | ---.---.---.vmsMessage.messageIndex | ---.---.---.vmsMessage.messageIndex | |
| X | ---.---.---.---.timeLastSet | ---.---.---.---.timeLastSet | |
| ---.---.---.---.---.DisplayAreaSettings | Nieuwe (tussen)laag in xml-boom in versie 3 | ||
| ---.---.---.---.---.DisplayAreaSettings.displayAreaIndex | Nieuw in versie 3, vul dit element met de waarde 1 | ||
| ---.---.---.---.---.DisplayAreaSettings xsi:type="MultiPageDisplay" | |||
| X | ---.---.---.---.textPage | ---.---.---.---.---.---.DisplayAreaSettings | |
| X | ---.---.---.---.textPage.pageNumber | ---.---.---.---.---.---.DisplayAreaSettings.pageNumber | |
| X | ---.---.---.---.---.vmsText | ---.---.---.---.---.---.DisplayAreaSettings xsi:type="TextDisplay" | |
| X | ---.---.---.---.---.---.vmsTextLine | ---.---.---.---.---.---.---.textLine | |
| X | ---.---.---.---.---.---.vmsTextLine.lineIndex | ---.---.---.---.---.---.---.textLine.lineIndex | |
| X | ---.---.---.---.---.---.---.vmsTextLine | ---.---.---.---.---.---.---.---.textLine | |
| X | ---.---.---.---.---.---.---.---.vmsTextLine | ---.---.---.---.---.---.---.---.---.textLine | |
| X | ---.---.---.---.vmsPictogramDisplayArea | (Nog) niet gemapt | Element niet gevonden in snapshot Nederlandse data |
| X | ---.---.---.---.vmsPictogramDisplayArea.pictogramDisplayAreaIndex | (Nog) niet gemapt | Element niet gevonden in snapshot Nederlandse data |
| X | ---.---.---.---.---.vmsPictogramDisplayArea | (Nog) niet gemapt | Element niet gevonden in snapshot Nederlandse data |
| X | ---.---.---.---.---.---.VmsPictogram | (Nog) niet gemapt | Element niet gevonden in snapshot Nederlandse data |
| X | ---.---.---.---.---.---.VmsPictogram.pictogramSequencingIndex | (Nog) niet gemapt | Element niet gevonden in snapshot Nederlandse data |
| X | ---.---.---.---.---.---.---.vmsPictogram | (Nog) niet gemapt | Element niet gevonden in snapshot Nederlandse data |
| X | ---.---.---.---.---.---.---.---.pictogramDescription | (Nog) niet gemapt | Element niet gevonden in snapshot Nederlandse data |
| X | ---.---.---.---.---.---.---.---.pictogramCode | (Nog) niet gemapt | Element niet gevonden in snapshot Nederlandse data |
| X | ---.---.---.---.---.---.---.---.presenceOfRedTriangle | (Nog) niet gemapt | Element niet gevonden in snapshot Nederlandse data |
| X | ---.---.---.---.vmsMessageExtension | Niet nodig om te mappen, boomstructuur verandert in versie 3 | |
| X | ---.---.---.---.---.vmsMessageExtension | Niet nodig om te mappen, boomstructuur verandert in versie 3 | |
| X | ---.---.---.---.---.---.vmsImage | ---.---.---.---.image | |
| X | ---.---.---.---.---.---.---.imageData | Niet nodig om te mappen, boomstructuur verandert in versie 3 | |
| X | ---.---.---.---.---.---.---.---.binary | ---.---.---.---.---.imageData | |
| X | ---.---.---.---.---.---.---.---.encoding | Hoeft niet gemapt te worden; dat het een Base64Binary betreft, is in versie 3 meegespecificeerd in imageData | |
| X | ---.---.---.---.---.---.---.---.mimeType | ---.---.---.---.---.imageFormat | Met recoding image/png ---> png |