View source for TT:topologyReference


{{missing information|topic=referencing from parent element <code>trainPartSequence</code>|user=[[User:Coordination|Coordination]] ([[User talk:Coordination|talk]]) 09:11, 23 October 2017 (CET)}}

{{ElementDocu|
elementName = topologyReference

|semantics =
The {{TT:Doc|topologyReference}} element {{Intro|2.4}} can be used to refer the underlying topology, which was used to determine the train running path and calculate the runtimes. Specifying the topology register and an optional time period, the attribute {{Attr|entry}} is used to refer to the external version / variant within the topology register. This assumes that the reading system also knows the topology register and can interpret the version / variant definition. When specifying multiple topology references, these must have a disjoint time period and, combined together, cover at least the operating days of the train.

{{deu|Mit dem {{TT:Doc|topologyReference}} Element {{intro|2.4}} kann für einen Zug die zugrundeliegende Topologie, welche für die Ermittlung des Fahrweges und Berechnung der Fahrzeiten verwendet wurde, referenziert werden. Unter Angabe des Topologie-Registers sowie einer optionalen Zeitperiode wird mit dem Attribut {{Attr|entry}} die Version / Variante innerhalb der externen Topologie referenziert. Dies setzt voraus, dass das lesende System das Topologie-Register ebenfalls kennt und die Version / Variante interpretieren kann. Bei der Angabe mehrerer Referenzen müssen diese einen disjunkten Zeitraum haben sowie in der Kombination mindestens die Betriebstage des Zuges abdecken. }}

|parent = {{TT:Tag|trainPartSequence}} (both types)
|childs=''None''
|minocc=0
|maxocc=∞
|inheritedAttributes=''None''

|ownAttributes =
* {{Attr|register}}: A string value for defining the catalogue, index, or directory where the external topology reference comes from or refers to. Attribute register is used to link a topologyReference with the [[dev:Codelists|codelist]] ''Registers.xml''. See below for a list of the currently registered catalogues.
* {{Attr|entry}}: Contains the external key of the referred register.
* {{Attr|startDate}}: Begin of the validity period for the topology reference. 
* {{Attr|endDate}}: End of validity period for the topology reference.

{{InheritAnyAttribute
|anyAttribute =
|anyAttribute_de =
}}

|constraints =
* {{Attr|register}} {{XsdType|string}}, required: Existing string value entries shall be used for the assigned registers and must not be used for other databases.<br>For short-time or internal purposes new string value entries can be used additional to those provided by the {{rml}} XSD, but for official data exchange between two software programs it is '''strongly''' recommended that each new 'register' entry has to be 'registered' at {{site|https://www.railml.org/en/user/subschemes/infrastructure.html|{{rml}}'s IL scheme coordinator}} and included into the [[dev:Codelists|codelist]] ''Registers.xml'' for free.
* {{Attr|entry}}: {{xsdType|string}}, required: May be a string or a number depending on the 'register'. This means, some 'register' entries require a pure numeric number and do not allow characters or other signs. This is not forced by {{rml}} so far. 
* {{Attr|startDate}}: {{XsdType|date}}, optional
* {{Attr|endDate}}: {{XsdType|date}}, optional

|notes =
Currently predefined 'register' enumeration entries:
* {{Enum|ENEE}} Station code of ENEE database managed (based on {{external|https://en.wikipedia.org/wiki/International_Union_of_Railways|UIC}}/{{external|https://en.wikipedia.org/wiki/Organization_for_Cooperation_of_Railways|OSJD}} Leaflet/IRS 920-2) by UIC. See {{external|https://www.uic.org/location-codes-enee|the UIC download page}} for more details.
* {{Enum|PLC}} Primary location code of the Telematics applications for freight (see "TAF TSI - Annex D.2 : Appendix C - Reference Files" {{external|https://www.era.europa.eu/Document-Register/Pages/TAF-TSI.aspx}}).
* {{Enum|IBNR}} Numbers used in some public timetable databases and some customer information systems (EFZ - Europäisches Fahrplanzentrum der DB; Frankfurt/Main). This enumeration entry requires the value to be an integer number.
* {{Enum|CRD}} Common Reference Database of {{external|https://www.era.europa.eu|ERA}}
* {{Enum|RL100}}: German station abbreviation database of most German and some European ''(if served by DB's trains only)'' stations, maintained in DB's rule Ril 100 by {{external|https://en.wikipedia.org/wiki/DB_Netze|DB Netze}}<br>{{deu|"Betriebsstellenkürzel" der Deutschen Bahn; Quelle: Richtlinie 100 (Ril 100; früher auch DS100) der DB Netz AG; weitere Informationen siehe {{external|https://de.wikipedia.org/wiki/Betriebsstellenverzeichnis|Wikipedia-Artikel|lang=de|inlang=de}}}}
* {{Enum|DB640}} Austrian "Dienstbehelf No. 640" of Österreichische Bundesbahnen.
* {{Enum|SR70}} Czech Republic {{external|https://www.szdc.cz/dalsi-informace/dokumenty-a-predpisy.html?prescriptline&#61;SR|"Služební rukověť 70"}}, SŽDC Czech Republic national railway infrastructure manager
* {{Enum|LVV}} Dutch "Lijst van verkortingen" of Nederlandse Spoorwegen N.V.
* {{Enum|GAIA}} French "Gaïa" of SNCF Réseau
* {{Enum|DRR-BE}} Belgian "Document de Référence du Réseau" of Infrabel
* {{Enum|DIDOK}} Swiss {{external|https://data.geo.admin.ch/ch.bav.haltestellen-oev|Dienststellendokumentation"}} of Schweizerische Bundesbahnen on behalf of {{external|https://www.bav.admin.ch|Bundesamt für Verkehr}} ({{external|https://map.geo.admin.ch/?layers&#61;ch.bav.haltestellen-oev|Map}}).
* {{Enum|DfA}} Swiss "Datenbank Feste Anlagen" of Schweizerische Bundesbahnen on behalf of {{external|https://www.bav.admin.ch|Bundesamt für Verkehr}}
* {{Enum|UNO}} Swiss central topology database for railway systems of Schweizerische Bundesbahnen on behalf of {{external|https://www.bav.admin.ch|Bundesamt für Verkehr}}

|example = 
The following trainPartSequence has two references in the UNO topology register. The first one references the external topology version used to determine the train running path and calculate the runtimes from 1 February to 31 August 2017 of the train operating days. The second reference points to the external version used for the operating days from 1 September to 31 December 2017. 

Thus, for the train operating days from 1 February to 31 August 2017 the UNO topology version "183000-01012017" is used. For the operating days from 1 September to 31 Decenber 2017 the UNO version "120000-08012017" is referenced.

<syntaxhighlight lang="xml">
<trainPartSequence sequence="1">
    <trainPartRef ref="train-part-1" />
    <topologyReference register="UNO" entry="183000-01012017" startDate="2017-02-01" endDate="2017-08-31" />
    <topologyReference register="UNO" entry="120000-08012017" startDate="2017-09-01" endDate="2017-12-31" />
</trainPartSequence>
</syntaxhighlight>
}}