IS:elementState

From railML 3 Wiki
Jump to navigation Jump to search

Introduction

This element allows to represent statements like the following:

  • the whole infrastructure except element "xxx" from "2002-09-24-06:00" to "2002-09-30-06:00" was is state "operational".
  • element "xxx" from "2002-09-24-06:00" to "2002-09-30-06:00" was is state "closed".
  • the whole infrastructure except element "xxx" from "2022-09-24-06:00" to "2022-09-30-06:00" was is state "conceptual".
  • element "xxx" from "2022-09-24-06:00" to "2022-09-30-06:00" was is state "disabled".
  • the state from "2002-09-30-06:00" to "2022-09-24-06:00" is undefined.
🗒️ In order to provide a solution that is more general and also allows for example rolling stock information to carry status information railML.org came up with a more general approach. As of railML® 3.3 what is known in railML® 3.2 as infrastructure states is defined in Common.

See CO:elementState for further information.

For context see corresponding:

 


Documentation

Syntax

This element does not appear in railML® 3.3 within the IS subschema. It is available only in railML® 3.13.2. Do not hesitate to contact railML.org for further questions.

Autoexport from the XML-Schema for element IS:elementState of railML® version 3.2
    
Documentation list of infrastructure elements in a certain state that belong to this infrastructure state
Subschema infrastructure
Parents*

infrastructureState

Children

name (0..*), validityTime (0..*)

Attributes:
  • refersToElement: reference to any element of infrastructure model (optional; xs:string; patterns: (urn:uuid:)?[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}|{[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}}),

  • value: railway infrastructure element functional state, e.g. "operational" (optional; xs:string; patterns: other:w{2,}; consider Dev:UsingAny too.)
Possible values:
  • closed: The element is no longer available, removed, dismantled, or no longer exists. Planning, construction or commissioning activities are absolutely necessary for recommissioning.
  • 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.
  • 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.
  • operational: The element is operational and can be used regularly.
  • 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.,

  • id: unique identifier (obligatory; xs:string; patterns: (urn:uuid:)?[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}|{[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}}); compare: Dev:Identities
*Notice:
Elements may have different parent elements. As a consequence they may be used in different contexts.
Please, consider this as well as a user of this Wiki as when developing this documentation further.
Aspects that are only relevant with respect to one of several parents should be explained exclusively in the documentation of the respective parent element.


 

Autoexport from the XML-Schema for element IS:elementState of railML® version 3.1
    
Documentation list of infrastructure elements in a certain state that belong to this infrastructure state
Subschema infrastructure
Parents*

infrastructureState

Children

any (0..*), name (0..*), validityTime (0..*)

Attributes:
  • refersToElement: reference to any element of infrastructure model (optional; xs:IDREF; patterns: (urn:uuid:)?[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}|{[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}}),

  • value: railway infrastructure element functional state, e.g. "operational" (optional; xs:string; patterns: other:w{2,}; consider Dev:UsingAny too.)
Possible values:
  • 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.
  • closed: The element is no longer available, removed, dismantled, or no longer exists. Planning, construction or commissioning activities are absolutely necessary for recommissioning.
  • operational: The element is operational and can be used regularly.
  • 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.
  • 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.,

  • id: unique identifier (optional; xs:ID; patterns: (urn:uuid:)?[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}|{[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}}); compare: Dev:Identities
*Notice:
Elements may have different parent elements. As a consequence they may be used in different contexts.
Please, consider this as well as a user of this Wiki as when developing this documentation further.
Aspects that are only relevant with respect to one of several parents should be explained exclusively in the documentation of the respective parent element.


 


Changes 3.1→3.2

There exists an overview of all changes between railML® 3.1 and railML® 3.2 on page Dev:Changes/3.2.

The parents have been changed.

The children have been changed.

The attributes have been changed.

Changes 3.2→3.3

There exists an overview of all changes between railML® 3.2 and railML® 3.3 on page Dev:Changes/3.3.

Removed with version 3.3.

Semantics

Best Practice / Examples

Additional Information

Notes

When this element was moved to CO:elementState in railML® 3.3, two new state values were also introduced: withdrawn and dismantled. The new value withdrawn is not covered by any of the values available in previous versions. When working with multiple versions of railML®, this value can be given as other:withdrawn in previous versions. The new value dismantled is a subset of the old value closed. When working with multiple versions of railML® both closed and dismantled map to closed in previous versions.

Open Issues