IS:uptime
uptime
Schema description / Schemabeschreibung
Position of uptime in the XML-Tree / Position von uptime im XML-Baum
- Parent: <propOperational>
- Children: None
Multiplicity / Anzahl
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" (see Best practice & Examples).
- until is the end time for the given mode. The value "00:00:00" shall be interpreted as midnight at the end of the day (see Best practice & Examples).
- mode extension of <state> to specify staff and temporary disabling. 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, starting with 'other:' followed by at least two letters and/or digits. Please see the section New enumeration value in Dev:UsingAny for more information.
- 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
|
|
|
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="00:00:00"
or from="00:00:00" until="24:00:00"
. In any case a midnight value in from shall be interpreted as midnight at the beginning of the day and a midnight value in until shall be interpreted as midnight at the end of the day. Although allowed in the XML standard, the value "24:00:00" is not handled by all XML libraries, notably the System.Xml library of Microsoft .NET, and may produce an error. Its use is therefore no longer recommended.
Notes / Anmerkungen
Not yet described. / Noch nicht beschrieben.
Open issues / Offene Punkte/Pendenzen
Not yet described. / Noch nicht beschrieben.