View source for Darwin:Train Order Element

= Train Order message =

== Overview ==

A Train order message indicates the order in which trains are expected to call/pass a station platform.

== Detail ==

Train order messages are contained in an 'trainOrder' (TrainOrder type) element which has TIPLOC, CRS code, and platform attributes.

* The TIPLOC is the TIPLOC supplied by the provider of the train order, so it may not be the same as the TIPLOC in the schedules referenced in the message.
* The TIPLOC and those referenced in the schedules will have the same CRS code

The train order message will either set a new train order, if it contains a 'set' element, or it can clear the previous train order message if it contains the 'clear' element instead.

If the message sets a new train order, the details of the order will be contained within 'first', 'second', and 'third' named TrainOrderData type elements inside the 'set' element. There can be up to three trains in the order, with each train identified either by [[RID]], or by train ID (headcode) if the [[RID]] is unavailable. Any combination of 'circular' times (i.e. wta/wtp/wtd, pta/ptd) may be provided within the element's attributes if a [[RID]] is provided, but will always be absent for a train ID.

== Examples (v16) ==

<pre><trainOrder tiploc="NORWDJ" crs="NWD" platform="1">
  <ns9:set>
    <ns9:first>
      <ns9:rid wta="20:53" wtd="20:54" pta="20:53" ptd="20:54">202301157147904</ns9:rid>
    </ns9:first>
    <ns9:second>
      <ns9:rid wta="20:57:30" wtd="20:58:30" pta="20:58" ptd="20:58">202301158861394</ns9:rid>
    </ns9:second>
  </ns9:set>
</trainOrder></pre>

<pre><trainOrder tiploc="SINFINN" crs="SIR" platform="1">
  <ns9:set>
    <ns9:first>
      <ns9:trainID>2M11</ns9:trainID>
    </ns9:first>
  </ns9:set>
</trainOrder></pre>

<pre><trainOrder tiploc="HGHI" crs="HHY" platform="2">
  <ns9:clear xmlns:ct="http://www.thalesgroup.com/rtti/PushPort/CommonTypes/v3" xmlns:tom="http://www.thalesgroup.com/rtti/PushPort/TrainOrder/v1"/>
</trainOrder></pre>

[[Category:National Rail Enquiries Data Feeds]]