IS:uptime

From railML 2 Wiki
Jump to navigation Jump to search


uptime
 


Scheme description / Schemenbeschreibung

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

Multiplicity / Anzahl

[0..∞]

Semantics / Bedeutung

The element <uptime> defines daytime constraints for the current ocp.
 
Please, be aware of the semantic constraint(s)!

Attributes of uptime / Attribute von uptime

  • from is the start time for the given mode. When referring to midnight at the beginning of the day, please use "00:00:00".
  • until is the end time for the given mode. When referring to midnight at the end of the day, please use "24:00:00".
  • mode Possible values are:
  • manned: The <ocp> is operational/usable and staffed with IM's personnel ready for operation on site (in the area of the <ocp>).
  • unmanned: The <ocp> is operational/usable and not staffed with on site personnel by the IM. Even if the <ocp> is not controlled or is remote controlled by any staff of the IM and there is no staff of the IM available in the area of the <ocp>.
  • off: The <ocp> is temporarily not operational/usable. No information about local staff is given by this value.

Please note that a long-term non-defined or permanent disabling of an <ocp> will be expressed via <ocp><propOther><state>@status={disabled|closed}.

  • 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: (introduced with version 2.5) reference to the operating period defined in the timetable part
  • endDayOffset: (introduced with version 2.5) define an offset greater than 0 if the end of the time span is not on the same day like the begin of the time span

Syntactic Constraints / Syntaktische Beschränkungen

  • from: xs:time, mandatory
  • until: xs:time, mandatory
  • mode: union of (restriction of xs:string, tOtherEnumerationValue); tOtherEnumerationValue is an arbitrary string starting with 'other:' followed by at minimum two characters, white space not allowed for extending railML® enumeration lists; mandatory
  • operatingPeriodRef: tGenericRef (xs:IDREF); optional
  • endDayOffset: xs:nonNegativeInteger; optional

Semantic Constraints / Semantische Beschränkungen

Private-cloud-icon.png Proposed Semantic Constraint "IS:008":
 
An <ocp> with <propOperational>@operationalType=blockSignal shall not have @mode=manned (as a manned blockSignal shall be modelled in railML® 2.x as a blockPost).
 
Proposed on February 28th 2020
FIXME: add Link to discussion!
Please, recognize our guidelines on semantic constraints

Private-cloud-icon.png Proposed Semantic Constraint "IS:009":
 
An <ocp> with attribute <propOperational>@operationalType=stoppingPoint shall not have @mode=manned (as a stoppingPoint has no operational usage and therefore no operational staff by the IM).
 
Proposed on February 28th 2020
FIXME: add Link to discussion!
Please, recognize our guidelines on semantic constraints

Private-cloud-icon.png Proposed Semantic Constraint "IS:010":
 
An enumeration of several time periods by @from and @until for one <ocp> shall not overlap so that for every time there shall be a unique status of <uptime>.
 
Proposed on February 28th 2020
FIXME: add Link to discussion!
Please, recognize our guidelines on semantic constraints

Best practice & Examples / Empfohlene Anwendung & Beispiele

As from and until are mandatory, a mode for the whole day must be specified from="00:00:00" until="24:00:00".

Notes / Anmerkungen

Not yet described. / Noch nicht beschrieben.

Open issues / Offene Punkte/Pendenzen

Not yet described. / Noch nicht beschrieben.