CO:infrastructureManager

From railML 2 Wiki
Jump to navigation Jump to search


infrastructureManager
 


Scheme description / Schemenbeschreibung

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

Multiplicity / Anzahl

[0..∞]

Semantics / Bedeutung

Pre-defining a railway infrastructure manager, that is needed to refer from within the railML® data set. via code it can be linked to the codelist infrastructureManagers.xml, where numerous infrastructure managers are listed. The definition of an infrastructure manager is based on the EU definition Interop Directive 2016/797 (external link).

Definition eines EIU (Eisenbahninfrastrukturunternehmens (Wiki banner.png)), das in der railML®-Datei referenziert wird. Das Element kann über code mit der codelist infrastructureManagers.xml verbunden werden, wo zahlreiche Eisenbahninfrastrukturunternehmen geführt werden. Was ein Infrastrukturmanager ist, orientiert sich dabei an der durch die EU geprägten Definition[1].

Attributes of infrastructureManager / Attribute von infrastructureManager

  • id: XML-file-wide unique, machine-interpretable identity, required for later referencing that element internally. For a detailed explanation see Dev:identities.
    XML-Datei-weit eindeutige, maschineninterpretierbare Identität, die für die spätere interne Referenzierung dieses Elements erforderlich ist. Für eine detaillierte Erklärung siehe Dev:identities.
  • code (introduced with version 2.1): Machine-interpretable string (e.g. an abbreviation) used for identification of the object across exchange partners, usecase specific uniqueness constraints may apply. Please see our description of the differences between id, code and human-readable identifiers.
    Maschineninterpretierbare Zeichenkette (z.B. Abkürzung), die zur Identifizierung des Objekts auch bei Austauschpartnern verwendet wird, wobei spezifische Eindeutigkeitsbeschränkungen gelten können. Bitte beachten Sie unsere Erläuterung zu den Unterschieden zwischen id, code and menschenlesbaren Kennzeichnungen.
    The code provides the link to the codelist infrastructureManagers.xml'
  • name: Established, human-readable short string, giving the object a name. Not intended for machine interpretation, please see our notice on human interpretable data fields.
    Etablierte, menschenlesbare kurze Zeichenkette, die das Objekt benennt. Nicht zur maschinellen Interpretation bestimmt, siehe Hinweise zu menschenlesbaren Datenfeldern.
  • description: Human-readable, more detailed description as addition to the name. It should give additional explanations or hints to the contents of this element. Not intended for machine interpretation, please see our notice on human interpretable data fields.
    Menschenlesbare, detailliertere Beschreibung als Ergänzung zu name. Sie soll zusätzliche Erläuterungen oder Hinweise auf den Inhalt dieses Elements geben. Nicht zur maschinellen Interpretation bestimmt, siehe Hinweise zu menschenlesbaren Datenfeldern.
  • xml:lang (introduced with version 2.1): This is a unique identifier of language. It uses basically the language standard IETF BCP 47 (external link) which may be different to ISO 639-1 (external link) or ISO 639-2 (external link). For mapping hints see relation to other standards (external link).
    This defines the language used for name and description. Use <additionalName> to provide a name and/or description in other languages.

Syntactic Constraints / Syntaktische Beschränkungen

  • id: xs:ID, required
    a string, starting with a letter (a..zA..Z) or an underscore (_),
    followed by a non-colonized and non-spaced string consisting of letters, digits, points (.), dashes (-) or underscores (_)
  • code: xs:string, optional
  • name: xs:string, optional
  • description: xs:string, optional
  • xml:lang: xs:language, language identification, optional

The Element <infrastructureManager> may occur several times.

Best practice & Examples / Empfohlene Anwendung & Beispiele

<railML ...>
  <metadata>
    <organizationalUnits>
      <infrastructureManager id="33e19910-794d-4afc-88f3-b5f27a3f6a6a"
                             code="ÖBB"
                             xml:lang="de-AT">
        <additionalName name="Austrian Federal Railways" 
                        xml:lang="en"/>
      </infrastructureManager>
    </organizationalUnits>
  </metadata>
  ...
</railML>

For the attribute code in element <infrastructureManager> please use the matching value from the codelist file InfrastructureManagers.xml. In this example, the code ÖBB is given.

Für den Wert des Attributs code im Element <infrastructureManager> wählen Sie bitte den entsprechenden Eintrag aus der von railML.org bereitgestellten Codelist InfrastructureManagers.xml. Im Beispiel heißt der Code ÖBB.

For further examples see also Dev:Border between infrastructure managers and countries.

Notes / Anmerkungen

None.

Open issues / Offene Punkte/Pendenzen

Not yet described. / Noch nicht beschrieben.