TT:specialService operatingPeriod

specialService
 

Schema description / Schemabeschreibung

Position of specialService in the XML-Tree / Position von specialService im XML-Baum

• Parent: <operatingPeriod>
• Children: None

Multiplicity / Anzahl

[0..∞]

Semantics / Bedeutung

The Element <specialService> describes a calendar based modification of the operatingPeriod by including or excluding certain days or periods. The maximal duration of the underlying timetablePeriod and operatingPeriod may not be expanded with a this <specialService>.

Das Element <specialService> beschreibt die auf einen Kalender bezogene Modifizierung einer Verkehrsperiode operatingPeriod um einzelne Zusatz- und/oder Ausfalltage oder auch Zusatz- und/oder Ausfallperioden. Die maximale Dauer der zugrundeliegenden Fahrplanperiode timetablePeriod beziehungsweise der darauf basierenden Verkehrsperiode operatingPeriod darf dabei aber nicht erweitert werden.
 
Please, be aware of the semantic constraint(s)!

Attributes of specialService / Attribute von specialService

• type: It has to follow the constraints of xs:string. Possible values are:

• include for additional traffic days
• exclude to exclude days

• singleDate: This is used to include or exclude a single day.
• startDate: This is used to include or exclude a time period. Please, take notice of the semantic constraint.
• endDate: This is used to include or exclude a time period. Please, take notice of the semantic constraint.
• startTime: This is used for a more detailed description of the time period.
  (deprecated with version 2.4)
• endTime: This is used for a more detailed description of the time period.
  (deprecated with version 2.4)
• xs:anyAttribute: (introduced with version 2.3) This provides an extension point for non-railML^® attributes in a foreign namespace. How to use it?

Syntactic Constraints / Syntaktische Beschränkungen

• type xs:string, mandatory

• singleDate xs:date, optional

• startDate xs:date, optional

• endDate xs:date, optional

• startTime xs:time, optional; shall be lower or equal endDate if both are used.

• endTime xs:time, optional; shall be higher or equal startDate if both are used.

Semantic Constraints / Semantische Beschränkungen

Semantic Constraint "TT:018":   Any starting time stamp (as it may result e.g. from a combination of startDate and startTime) shall be lower or equal any ending time stamp (e.g. endDate) if both are given. Must not overlap with other <specialService> validity periods of the same enclosing <operatingPeriod>.   Proposed on November 12th 2018 Approved on March 21st 2019 FIXME: add Link to discussion! Please, recognize our guidelines on semantic constraints

Best practice & Examples / Empfohlene Anwendung & Beispiele

<specialService type="include" singleDate="2009-12-24"/>

Weitere Informationen und railML^®-Beispiel zu Verkehrstagen (externer Link, PDF; 185 kBytes)

Notes / Anmerkungen

Not yet described. / Noch nicht beschrieben.

Open issues / Offene Punkte/Pendenzen

Not yet described. / Noch nicht beschrieben.