Darwin:TimeTableId element: Difference between revisions

Latest revision as of 10:35, 9 May 2023

The TimeTableId element indicates when a new timetable or timetable reference file is created. The element itself will always contain the timetable ID itself, and the filename of either the timetable or timetable reference file to which it refers.

Attribute name	Required?	Type	Remark
(element contents)	Y	`ct:TimetableIDType`: 14 chars string	e.g. `20230415020501`, which corresponds to 2023-04-05, at 02:05:01
ttfile	N	`ct:TimetableFilenameType`: 1..128 chars string	e.g. `20230415020501_v4.xml.gz`
ttreffile	N	`ct:TimetableFilenameType`: 1..128 chars string	e.g. `20230415020501_ref_v1.xml.gz`

Note that while ttfile and ttreffile are nominally optional, both fields are always supplied, although only one will be filled at any given time. In order to comply with the type restriction in the schema, a blank filename is represented as a single space.

For more information about how to interpret these messages, see Push Port - Keeping up to date

Examples (v16)

<Pport xmlns="http://www.thalesgroup.com/rtti/PushPort/v16" ... ts="2023-04-15T02:11:23.8739014+01:00" version="16.0">
  <TimeTableId ttfile="20230415020501_v4.xml.gz" ttreffile=" ">20230415020501</TimeTableId>
</Pport>

<Pport xmlns="http://www.thalesgroup.com/rtti/PushPort/v16" ... ts="2023-04-15T02:11:29.8789014+01:00" version="16.0">
  <TimeTableId ttfile="20230415020501_v5.xml.gz" ttreffile=" ">20230415020501</TimeTableId>
</Pport>

<Pport xmlns="http://www.thalesgroup.com/rtti/PushPort/v16" ... ts="2023-04-15T02:11:17.9599014+01:00" version="16.0">
  <TimeTableId ttfile=" " ttreffile="20230415020501_ref_v1.xml.gz">20230415020501</TimeTableId>
</Pport>

@@ Line 12: / Line 12: @@
 |}
-Note that while ttfile and ttreffile are nominally optional, both fields are usually supplied, although only one will be filled at any given time. In order to comply with the type restriction in the schema, a blank filename is represented as a single space.
+Note that while ttfile and ttreffile are ''nominally'' optional, both fields are always supplied, although only one will be filled at any given time. In order to comply with the type restriction in the schema, a blank filename is represented as a single space.
-Note that one message will be issued for each version of a given file, it may be necessary to filter on the version contained in the filename.
+For more information about how to interpret these messages, see [[Darwin:Push_Port#Keeping_up_to_date|Push Port - Keeping up to date]]
 == Examples (v16) ==