From railML 2 Wiki
Jump to navigation Jump to search


💡 (introduced with version 2.5)
This element was introduced with version 2.5.
Dieses Element wurde mit Version 2.5 eingefĂŒhrt.

Scheme description / Schemenbeschreibung

Position of RS:state in the XML-Tree / Position von RS:state im XML-Baum

Multiplicity / Anzahl


Semantics / Bedeutung

This is to define disabled/enabled pieces of rolling stock with a given time frame. For consistency reasons the wording is analogous to the IS-<state>-element.(introduced with version 2.5)
Please, be aware of the semantic constraint(s)!

Attributes of RS:state / Attribute von RS:state

  • disabled: This attribute is 'true' if the rollingstock piece is somehow disabled.
  • status: (introduced with version 2.4) defines the status of the rollingstock element from perspective of its availability
    Possible values are:
    Mögliche Werte sind:
  • conceptual The construction or commissioning of the element is planned for the medium or long term. However, there are still no concrete (planning) activities for the construction of the element beyond the preliminary planning and cost estimation.
    Der Bau oder die Inbetriebnahme des Elements ist mittel- oder langfristig vorgesehen. Es gibt aber ĂŒber die Vorplanung und KostenschĂ€tzung noch keine konkreten (Planungs-)AktivitĂ€ten fĂŒr die Errichtung des Elements.
  • planned The construction or commissioning of the element is planned concretely and at short notice or concrete planning activities for the construction take place, e.g. design, approval or implementation planning, cost calculation, award of contracts. It is not normally possible to use the element.
    Der Bau oder die Inbetriebnahme des Elements ist konkret und kurzfristig vorgesehen bzw. es finden konkrete PlanungsaktivitĂ€ten fĂŒr die Errichtung statt wie z.B. Entwurfs-, Genehmigungs- oder AusfĂŒhrungsplanung, Kostenkalkulation, Vergabe. Eine Nutzung des Elements ist regulĂ€r nicht möglich.
  • operational The element is operational and can be used regularly.
    Das Element ist betriebsfÀhig vorhanden und kann regulÀr benutzt werden.
  • disabled The element is currently not usable, switched off or deactivated and therefore cannot be used regularly. However, it can be put back into operation at short notice without further construction, acceptance or approval activities.
    Das Element ist gegenwÀrtig nicht verwendbar oder aktiviert und kann daher regulÀr nicht benutzt werden. Es kann aber ohne weitere Bau-, Abnahme- oder GenehmigungsaktivitÀten kurzfristig wieder in Betrieb genommen werden.
  • closed The element is no longer available, removed, dismantled, or no longer exists. Planning, construction or commissioning activities are absolutely necessary for recommissioning.
    Das Element ist endgĂŒltig nicht mehr verfĂŒgbar, abgebaut oder nicht mehr vorhanden. FĂŒr eine Wiederinbetriebnahme sind Planungs-, Bau- oder InbetriebnahmeaktivitĂ€ten zwingend notwendig.
  • unknown (introduced with version 2.5) The state of the respective element is explicitly unknown.
    Der Status des betreffenden Elementes ist ausdrĂŒcklich nicht bekannt.
  • 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.
  • operatingPeriodRef: The start date (or start dates if its a periodic state) should be defined in the 'timetable' part of the railMLÂź file, using the 'operatingPeriod' element.
  • startTime: (introduced with version 2.4) The start time of the 'state'.
  • endTime: (introduced with version 2.4) The end time of the 'state'.
  • endDayOffset: (introduced with version 2.4) Duration of the 'state', counted in midnight overruns.
  • remarks: This is to further explain the 'state' definition.
💡 Please take into account our references to human-intepretable data fields.

Bitte berĂŒcksichtigen Sie unsere Hinweise zu menschen-intepretierbaren Datenfeldern.

Syntactic Constraints / Syntaktische BeschrÀnkungen

Semantic Constraints / Semantische BeschrÀnkungen

Private-cloud-icon.png Semantic Constraint "RS:004":
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 <state> validity periods of the same enclosing <vehicle>/<states>.
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

The <states> element is optional. In case that no specific <state> is defined for the parent rollingstock element this rollingstock element remains "valid" without any further constraints.
Das <states> Element ist optional. FĂŒr den Fall, dass kein expliziter <state> fĂŒr das ĂŒbergeordnete Rollingstock-Element angegeben ist existieren keine EinschrĂ€nkungen hinsichtlich der GĂŒltigkeit/VerfĂŒgbarkeit dieses Rollingstock-Elements.

Notes / Anmerkungen

Not yet described. / Noch nicht beschrieben.

Open issues / Offene Punkte/Pendenzen

Not yet described. / Noch nicht beschrieben.