TT:specialService operatingPeriodRef

specialService
 

Scheme description / Schemenbeschreibung / Description du schéma

Position of specialService in the XML-Tree / Position von specialService im XML-Baum / position de specialService dans l’aborescence XML

• Parent: <operatingPeriodRef>

• Children: None

Multiplicity / Anzahl / Multiplicité

[1..1]

Semantics / Bedeutung / Sémantique

(deprecated with version 2.2) — use reference to individual operating period instead.
 
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 / Attributs de specialService

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

In this article there is information missing with respect to the semantics of the enumeration items. Please help improving the railML® wiki by filling the gaps. Possibly, you will find further details on the discussion page. Ferri Leberl (talk) 16:14, 25 April 2018 (CEST)

• include
• exclude

• singleDate: This is used to include or exclude a single day.
• startDate: This is used to include or exclude a time period. Please, recognize the semantic constraint.
• endDate: This is used to include or exclude a time period. Please, recognize the semantic constraint.
• startTime: (deprecated with version 2.4) This is used for a more detailed description of the time period.
• endTime: (deprecated with version 2.4) This is used for a more detailed description of the time period.
• 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 / Contraintes syntactiques

• type xs:string, mandatory

• singleDate xs:date, optional

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

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

• startTime xs:time, optional

• endTime xs:time, optional

Semantic Constraints / Semantische Beschränkungen / Contraintes semantiques

Semantic Constraint "TT:001": 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 validity periods. 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 / Bonnes pratiques & exemples

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

Notes / Anmerkungen / Notes

Not yet described. / Noch nicht beschrieben. / Pas encore décrit.

Open issues / Offene Punkte/Pedenzen / Questions ouvertes

Not yet described. / Noch nicht beschrieben. / Pas encore décrit.