TT:trainPartSequence train: Difference between revisions

From railML 2 Wiki
Jump to navigation Jump to search
[unchecked revision][unchecked revision]
mNo edit summary
(Updated using new templates (Vorlage:InheritRef, Vorlage:RailMLType))
Line 1: Line 1:
{{elementDocu|
{{ElementDocu|
elementName = trainPartSequence
elementName = trainPartSequence
|semantics =
|semantics =
The element {{TT:Doc|trainPartSequence}} groups all elements {{TT:Doc|trainPart}} belonging to a train. The '''sequence''' herein is supposed to be used for successive parts along the train route. This is '''not''' to be mixed up with the sequence of rolling stock inside a train formation or a chronological sequence during an operating period or during a day. Therefore all referenced elements {{TT:Doc|trainPart}} of a {{TT:Doc|trainPartSequence}} should have the same starting point and end point. Otherwise you should define smaller (shorter) {{TT:Doc|trainParts}}.
The element {{TT:Doc|trainPartSequence}} groups all elements {{TT:Doc|trainPart}} belonging to a train. The {{Attr|sequence}} herein is supposed to be used for successive parts along the train route. This is ''not'' to be mixed up with the sequence of rolling stock inside a train {{RS:Doc|formation}} or a chronological sequence during an operating period or during a day. Therefore all referenced elements {{TT:Doc|trainPart}} of a {{TT:Doc|trainPartSequence}} should have the same starting point and end point. Otherwise you should define smaller (shorter) {{TT:Doc|trainParts}}.
 
{{deu|Das Element {{TT:Doc|trainPartSequence}} gruppiert alle zu einem Zug gehörigen Elemente {{TT:Doc|trainPart}}. Dabei ist die {{Attr|sequence}} im Sinne einer Abfolge der Betriebsstellen im Zuglauf zu verstehen. Dies darf ''nicht'' verwechselt werden mit der Abfolge der Zugteile innerhalb einer Zugkonfiguration und auch nicht mit der zeitlichen Abfolge von Betriebstagen innerhalb einer Verkehrsperiode. Die innerhalb einer {{TT:Doc|trainPartSequence}} referenzierten Zuglaufteile {{TT:Doc|trainPart}} müssen daher alle den gleichen Start- und Endpunkt aufweisen. Ansonsten müssen kleinere (kürzere) Zuglaufteile {{TT:Doc|trainPart}} als Bausteine definiert werden.}}
 
|parent = {{TT:Tag|train}}
 
|childs = {{TT:Tag|trainPartRef}}, {{TT:Tag|equipmentUsage}}, {{TT:Tag|brakeUsage}}
 
|ownAttributes =
* {{Attr|sequence}}: This is the sequence of successive train parts along the train route ({{xsdType|integer}})


{{deu|Das Element {{TT:Doc|trainPartSequence}} gruppiert alle zu einem Zug gehörigen Elemente {{TT:Doc|trainPart}}. Dabei ist die '''sequence''' im Sinne einer Abfolge der Betriebsstellen im Zuglauf zu verstehen. Dies darf '''nicht''' verwechselt werden mit der Abfolge der Zugteile innerhalb einer Zugkonfiguration und auch nicht mit der zeitlichen Abfolge von Betriebstagen innerhalb einer Verkehrsperiode. Die innerhalb einer {{TT:Doc|trainPartSequence}} referenzierten Zuglaufteile {{TT:Doc|trainPart}} müssen daher alle den gleichen Start- und Endpunkt aufweisen. Ansonsten müssen kleinere (kürzere) Zuglaufteile {{TT:Doc|trainPart}} als Bausteine definiert werden.}}
* {{Attr|pathStatus}}: This is the status of the train path. It could be used if a {{TT:Doc|train}} is involved in a train paths allocation process. Possible values are:
:* {{Enum|planned}}
:* {{Enum|ordered}}
:* {{Enum|confirmed}}
:* {{Enum|detailsRefused}}
:* {{Enum|cancelled}}
:* {{Enum|notAvailable}}
:* {{OtherEnum
|notes_en =
}}


|parent = {{TT:Doc|train}}
{{InheritRef
|attributeName = categoryRef
|contextLink = {{TT:Tag|category}}
|notes_en = This is the category of a {{TT:Doc|train}} which could differ (by its meaning) from a category of a {{TT:Doc|trainPart}}.
}}


|childs = {{TT:Doc|trainPartRef}}, {{TT:Doc|equipmentUsage}}, {{TT:Doc|brakeUsage}}
|constraints =
* {{Attr|sequence}} mandatory


|inheritedAttributes =
* {{Attr|pathStatus}} optional


|ownAttributes =
* {{Attr|categoryRef}} {{RailMLType|tGenericRef}}, optional
*{{attr|sequence}}: the sequence of successive train parts along the train route ({{xsdType|integer}}, required)
*{{attr|pathStatus}}: status of train path, could be used if train is involved in a train paths allocation process ({{xsdType|string}}, optional)
Possible values:
:* planned
:* ordered
:* confirmed
:* detailsRefused
:* cancelled
:* notAvailable
:* other:anything


|example =  
|example =  
Line 35: Line 49:
       <rail:trainPartRef ref="CNL_242_2"/>
       <rail:trainPartRef ref="CNL_242_2"/>
   </rail:train>
   </rail:train>


|backHome = TT:elements
|backHome = TT:elements
}}
}}

Revision as of 09:56, 7 December 2011


trainPartSequence
 


Scheme description / Schemenbeschreibung

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

Multiplicity / Anzahl

[1..1]

Semantics / Bedeutung

The element trainPartSequence groups all elements trainPart belonging to a train. The sequence herein is supposed to be used for successive parts along the train route. This is not to be mixed up with the sequence of rolling stock inside a train formation or a chronological sequence during an operating period or during a day. Therefore all referenced elements trainPart of a trainPartSequence should have the same starting point and end point. Otherwise you should define smaller (shorter) trainParts.

Das Element trainPartSequence gruppiert alle zu einem Zug gehörigen Elemente trainPart. Dabei ist die sequence im Sinne einer Abfolge der Betriebsstellen im Zuglauf zu verstehen. Dies darf nicht verwechselt werden mit der Abfolge der Zugteile innerhalb einer Zugkonfiguration und auch nicht mit der zeitlichen Abfolge von Betriebstagen innerhalb einer Verkehrsperiode. Die innerhalb einer trainPartSequence referenzierten Zuglaufteile trainPart müssen daher alle den gleichen Start- und Endpunkt aufweisen. Ansonsten müssen kleinere (kürzere) Zuglaufteile trainPart als Bausteine definiert werden.

Attributes of trainPartSequence / Attribute von trainPartSequence

  • sequence: This is the sequence of successive train parts along the train route (xs:integer)
  • pathStatus: This is the status of the train path. It could be used if a train is involved in a train paths allocation process. Possible values are:
  • planned
  • ordered
  • confirmed
  • detailsRefused
  • cancelled
  • notAvailable
  • other:anything: Any value that does not fit any value from the previous enumeration list, fulfilling the constraint: at minimum two characters, whitespace is not allowed. Please, apply Dev:usingAny accordingly.
  • categoryRef: This refers to the id attribute of the associated <category> element.
    This is the category of a train which could differ (by its meaning) from a category of a trainPart.

Syntactic Constraints / Syntaktische Beschränkungen

  • sequence mandatory
  • pathStatus optional

Best practice & Examples / Empfohlene Anwendung & Beispiele

Train City Night Line 242:

 <rail:train id="o242" type="operational" description="Berlin - Paris" trainNumber="242">
   <rail:trainPartSequence sequence="1"> <-- Berlin to Hannover
     <rail:trainPartRef position="1" ref="CNL_242_1"/>
     <rail:trainPartRef position="2" ref="CNL_1242_1"/>
   </rail:trainPartSequence>
   <rail:trainPartSequence sequence="2"> '<-- Hannover to Paris-Nord
     <rail:trainPartRef ref="CNL_242_2"/>
 </rail:train>

Notes / Anmerkungen

Not yet described. / Noch nicht beschrieben.

Open issues / Offene Punkte/Pendenzen

Not yet described. / Noch nicht beschrieben.