TT:operatingPeriodRef trainPart: Difference between revisions

From railML 2 Wiki
Jump to navigation Jump to search
[unchecked revision][checked revision]
(Die Seite wurde neu angelegt: {{elementDocu| elementName = operatingPeriodRef |semantics = The Element {{TT:Tag|operatingPeriodRef}} is used for referencing the {{DocTT|operatingPeriod}} for the {{...)
 
(20 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{elementDocu|
{{ElementDocu|
elementName = operatingPeriodRef
elementName = operatingPeriodRef


|semantics =
|semantics =
The Element {{TT:Tag|operatingPeriodRef}} is used for referencing the {{DocTT|operatingPeriod}} for the {{DocTT|trainPart}}.  
The Element {{TT:Tag|operatingPeriodRef}} is used for referencing the {{TT:Doc|operatingPeriod}} for the {{TT:Doc|trainPart}}.  


Das Element {{TT:Tag|operatingPeriodRef}} referenziert die zum {{DocTT|trainPart}} gehörige Verkehrsperiode.  
{{Deu|Das Element {{TT:Tag|operatingPeriodRef}} referenziert die zum {{TT:Doc|trainPart}} gehörige Verkehrsperiode.}}


|parent = {{DocTT|trainPart}}
|parent = {{TT:Tag|trainPart}}


|childs = {{DocTT|specialService}}
|childs = {{TT:Tag|specialService|operatingPeriodRef}} {{depr|2.2}}
|minocc=0
|inheritedAttributes =
{{InheritRefAny
|contextLink = {{TT:Tag|operatingPeriod}}
|ref =
|ref_de =
|anyAttribute =
|anyAttribute_de =
}}


|inheritedAttributes = see {{DocCO|tElementWithReference}}
|ownAttributes =
*{{attr|refID}}: references an {{DocTT|operatingPeriod}}.
* {{Attr|startDate}} {{depr|2.2}}: This describes optional further restrictions of the operating period.{{StartEndDoc}}
* {{Attr|endDate}} {{depr|2.2}}: This describes optional further restrictions of the operating period.{{StartEndDoc}}
|constraints =
* {{Attr|ref}} {{RailMLType|tGenericRef}}, mandatory
* {{Attr|startDate}} {{XsdType|date}}, optional {{depr|2.2}}; shall be lower or equal {{Attr|endDate}} if both are used.
* {{Attr|endDate}} {{XsdType|date}}, optional {{depr|2.2}}; shall be higher or equal {{Attr|startDate}} if both are used.
|semcon={{startEndCon}}
|notes =
Child element {{TT:Doc|specialService|operatingPeriodRef}} is deprecated from railML 2.2 on. An individual {{TT:Doc|operatingPeriod}} for each {{TT:Doc|trainPart}} should be referenced instead. See TRAC ticket {{ticket|158}}.


|ownAttributes =
|example =  
*{{attr|aTimePeriod}}: describes optional further restrictions of the operating period.
Normal reference to the {{TT:Doc|operatingPeriod}} for 'daily':
 
<rail:operatingPeriodRef ref="TGL"/>
 
* See also
:# [[TT:Midnight_overrun | How to indicate midnight overruns in railML]]
 
* '''iRFP Dresden''': selection of examples for operationg periods in German
:# {{external|http://www.irfp.de/download/railml_beispiel_verkehrstage.pdf|iRFP-Informationen und -Beispiel zu Verkehrstagen in railML|lang=DE|comment=by Dirk Bräuer, iRFP Dresden|date=May 2012}}


|backHome = TT:elements
}}
}}

Revision as of 13:52, 19 June 2020


operatingPeriodRef
 


Scheme description / Schemenbeschreibung

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

Multiplicity / Anzahl

[0..1]

Semantics / Bedeutung

The Element <operatingPeriodRef> is used for referencing the operatingPeriod for the trainPart.

Das Element <operatingPeriodRef> referenziert die zum trainPart gehörige Verkehrsperiode.
 
Please, be aware of the semantic constraint(s)!

Attributes of operatingPeriodRef / Attribute von operatingPeriodRef

  • ref: This refers to the id attribute of the associated <operatingPeriod> element.

Syntactic Constraints / Syntaktische Beschränkungen

  • ref xs:IDREF, mandatory
  • startDate xs:date, optional (deprecated with version 2.2); shall be lower or equal endDate if both are used.
  • endDate xs:date, optional (deprecated with version 2.2); shall be higher or equal startDate if both are used.

Semantic Constraints / Semantische Beschränkungen

Private-cloud-icon.png 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. See also https://wiki2.railml.org/wiki/Dev:Defining_temporal_availability_of_infrastructure_elements_and_speed_profiles
 
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

Normal reference to the operatingPeriod for 'daily': 

<rail:operatingPeriodRef ref="TGL"/>
  • See also
  1. How to indicate midnight overruns in railML
  • iRFP Dresden: selection of examples for operationg periods in German
  1. iRFP-Informationen und -Beispiel zu Verkehrstagen in railML (external link, May 2012, 🇩🇪; by Dirk Bräuer, iRFP Dresden)

Notes / Anmerkungen

Child element specialService is deprecated from railML 2.2 on. An individual operatingPeriod for each trainPart should be referenced instead. See TRAC ticket #158.

Open issues / Offene Punkte/Pendenzen

Not yet described. / Noch nicht beschrieben.

Retrieved from "https://wiki2.railml.org/index.php?title=TT:operatingPeriodRef_trainPart&oldid=10886"