Difference between revisions of "Darwin:Station Message Element"

From Open Rail Data Wiki
Jump to navigation Jump to search
(Add Station Message documentation)
 
m (Add class diagram)
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
= Station Messages message =
 
= Station Messages message =
 +
 +
[[File:RttiPPTStationMessages v1.png|thumb|Class diagram for the RttiPPTStationMessages_v1 schema]]
  
 
== Overview ==
 
== Overview ==
Line 12: Line 14:
  
 
* The Station elements contain an attribute 'crs' which contains the CRS code of the station
 
* The Station elements contain an attribute 'crs' which contains the CRS code of the station
* The Msg element can include HTML 'p' and 'a' elements, and may also include HTML entities, e.g. <code>&nbsp;</code> which may need translating if the message is sent to a non-HTML capable device
+
* The Msg element can include HTML 'p' and 'a' elements, and may also include HTML entities, e.g. <nowiki>&amp;nbsp;</nowiki> which may need translating if the message is sent to a non-HTML capable device
  
 
The 'id' attribute on the 'OW' element must be used to identify messages.  If a further station message is received with the same ID as a previous message, the message and list of stations to which it applies must be updated - either the message text, or the list of stations to which it applies may have changed, with stations added or removed.  If a station message is received with no stations shown, it implies that the message should no longer be shown at any station.
 
The 'id' attribute on the 'OW' element must be used to identify messages.  If a further station message is received with the same ID as a previous message, the message and list of stations to which it applies must be updated - either the message text, or the list of stations to which it applies may have changed, with stations added or removed.  If a station message is received with no stations shown, it implies that the message should no longer be shown at any station.
Line 77: Line 79:
 
| Severe
 
| Severe
 
|}
 
|}
 +
 +
[[Category:National Rail Enquiries Data Feeds]]

Revision as of 13:09, 5 March 2019

Station Messages message

Class diagram for the RttiPPTStationMessages_v1 schema

Overview

A Station Message is a message which relates to a list of stations. These are typically sent when there is a problem affecting services at a station or on a route.

These messages can also indicate that real-time running for trains at a station should be suppressed. For example, if a station is evacuated but trains are still running through, it is not appropriate to show trains at that location.

Detail

Station Messages are contained in an 'OW' element, with zero or more Station elements, and a single Msg element.

  • The Station elements contain an attribute 'crs' which contains the CRS code of the station
  • The Msg element can include HTML 'p' and 'a' elements, and may also include HTML entities, e.g. &nbsp; which may need translating if the message is sent to a non-HTML capable device

The 'id' attribute on the 'OW' element must be used to identify messages. If a further station message is received with the same ID as a previous message, the message and list of stations to which it applies must be updated - either the message text, or the list of stations to which it applies may have changed, with stations added or removed. If a station message is received with no stations shown, it implies that the message should no longer be shown at any station.

The 'OW' element also contains a category and severity, a list of which appears below. It may also contain a 'suppress' element set to a true value - if this is the case, the arrival and departure boards for this station should not be displayed, as the information may be inaccurate or misleading.

Example message

<OW id="48203" cat="Train" sev="1">
  <sm:Station crs="CDQ"/>
  <sm:Station crs="RDR"/>
  <sm:Station crs="TRD"/>
  <sm:Msg>
    <sm:p>Trains between Bridgend and Cardiff Central are being disrupted. More details can be found in <sm:a href="http://nationalrail.co.uk/service_disruptions/89943.aspx">Latest Travel News.</sm:a></sm:p>
  </sm:Msg>
</OW>

Categories

Category Meaning
Train Affects trains calling at a station
Station Related to the station, e.g. lifts or escalators
Connections Information on other services at a station, e.g. London Underground
System Related to the operation of Darwin, e.g. feed failure
Misc Anything not covered by another category
PriorTrains Advance notices of engineering work
PriorOthers Advance notices of other work, e.g. planned escalator maintenance work

Severities

Severity Meaning
0 Situation normal
1 Minor
2 Major
3 Severe