Dev:changes/2.5: Difference between revisions
[checked revision] | [checked revision] |
mNo edit summary |
(added description for extension of TT:category) |
||
Line 144: | Line 144: | ||
|nelem= | |nelem= | ||
|uelem={{tag|TT|ocpTT}} | |uelem={{tag|TT|ocpTT}} | ||
}} | |||
===New attribute {{@|parentRef|TT:category}} added=== | |||
{{change | |||
|fact=The attribute {{@|parentRef|TT:category}} was added in order to allow for hierarchies of categories. | |||
|reason=Requirement from the community. | |||
|recomendation= | |||
|trac={{ticket|437}} | |||
|svn= | |||
|example= | |||
|xsd= | |||
|nattr={{@|parentRef|TT:category}} | |||
|uattr= | |||
|nelem= | |||
|uelem={{tag|TT|category}} | |||
}} | |||
===New attribute {{@|organizationalUnitRef|TT:category}} added=== | |||
{{change | |||
|fact=The attribute {{@|organizationalUnitRef|TT:category}} was added in order to differentiate between categories of the same name that are related to different organizationalUnits and thus may differ in semantics. | |||
|reason=Requirement from the community. | |||
|recomendation= | |||
|trac={{ticket|436}} | |||
|svn= | |||
|example= | |||
|xsd= | |||
|nattr={{@|organizationalUnitRef|TT:category}} | |||
|uattr= | |||
|nelem= | |||
|uelem={{tag|TT|category}} | |||
}} | }} | ||
Revision as of 13:28, 20 April 2021
| ||||||||
| ||||||||
railML® 3 Wiki – RailTopoModel® Wiki |
railML® schema changes between railML® 2.4 and railML® 2.5
|
This site is intended to collect the schema changes between railML® 2.4 and railML® 2.5.
A complete diff comparison will soon be available under Dev:changes/2.5/diff.
Changes are also marked on the element pages with (introduced with version 2.5) for introduced components and (deprecated with version 2.5) for components that became obsolete. All occurances of these tags are listed in Category:Intro/2.5 respectively Category:Depr/2.5.
For changes with other version upgrades see Dev:changes.
Timetable Subschema
New @onRequest for <trainPart>
Fact: | new attribute @onRequest (bool) has been added in element <trainPart> in order to allow for standardized modelling of onRequest journeys. |
Reason: | Required by railML partner. Also this should help avoiding modelling of onRequest journeys using special train categories. |
Related Development Tickets: | #372 |
New attribute(s): | @onRequest |
Updated element(s): | <trainPart> |
New value other:anything for <category>@trainUsage
Fact: | <category>@trainUsage has been extended to allow for custom values |
Reason: | The demand for more distinguished categories appeared in this discussion (link to the railML® website) |
Related Development Tickets: | #375 |
Related Commits: | [1039] (Note on legacy SVN commits) |
Updated XSD file(s): | railwayBaseTypes.xsd |
Updated attribute(s): | <category>@trainUsage |
Updated element(s): | <category> |
New values conceptual and offered for <trainPartSequence>@pathStatus
Fact: | <trainPartSequence>@pathStatus has been extended to allow for the values conceptual and offered to improve how to express the state of an slot order |
Reason: | The demand for clearer modelling of the states for slot ordering showed up in [this discussion this discussion] (link to the railML® website) |
Related Development Tickets: | #378 |
Related Commits: | [1039] (Note on legacy SVN commits) |
Updated attribute(s): | <trainPartSequence>@pathStatus |
Updated element(s): | <trainPartSequence>@pathStatus |
New child <originalTrackInfo> for <ocpTT>
Fact: | New child <originalTrackInfo> for <ocpTT> |
Reason: | Allow for better communication of track changes |
Related Development Tickets: | #378 |
Related Commits: | [1039] (Note on legacy SVN commits) |
Updated XSD file(s): | timetable.xsd |
New element(s): | <originalTrackInfo> |
Updated element(s): | <ocpTT> |
New children <origin> and <destination> for <trainPart>
Fact: | New children <origin> and <destination> for <trainPart> |
Reason: | allows for specifying information about the origin/destination of the train if it cannot be derived from its path (trains entering/leaving the operated area). |
Related Development Tickets: | #378 |
Related Commits: | [1039] (Note on legacy SVN commits) |
New element(s): | <origin>, <destination> & their respective childs |
Updated element(s): | <trainPart> |
New Child <announcementRef> for <stopDescription> and <trainPart>
Fact: | New Child <announcementRef> for <stopDescription> and <trainPart> |
Reason: | broad revision of annotations |
Related Development Tickets: | #378 |
Related Commits: | [1039] (Note on legacy SVN commits) |
New element(s): | <announcementRef> & childs |
Updated element(s): | <stopDescription> |
New @type for <annotation>; changed multiplicity for <text>
Fact: | New @type for <annotation>; multiplicity of <text> changed from [1..∞] to [0..∞] |
Reason: | broad revision of annotations: annotations should point to other content than text. |
Related Development Tickets: | #358 |
Related Commits: | [1039] (Note on legacy SVN commits) |
New attribute(s): | <annotation>@type |
Updated element(s): | <annotation>, <text> |
New child <announcements> of <timetable>
Fact: | New child <announcements> of <timetable> |
Reason: | broad revision of annotations |
Related Development Tickets: | #358 |
Related Commits: | [1039] (Note on legacy SVN commits) |
New element(s): | <announcements> |
Updated element(s): | <timetable> |
@processStatus set to deprecated for <trainPart>, <train> and <trainGroup>
Fact: | The attribute @processStatus was set to deprecated for <trainPart>, <train> and <trainGroup>. |
Reason: | existing usage of attribute turned out to be non standardized. In order disencourage further use of the attribute it was decided to deprecate it as it seemed not feasible to unify its use. |
Related Development Tickets: | #364 |
Related Commits: | [1039] (Note on legacy SVN commits) |
Updated attribute(s): | processStatus |
Updated element(s): | <trainPart>, <train>, <trainGroup> |
@shuntingTime set to deprecated for <ocpTT>
Fact: | The attribute @shuntingTime was set to deprecated for <ocpTT>. |
Reason: | clarification of specification of shuntingTimes. There were actually 2 ways of specifying shunting times. @shuntingTime was deprecated in favor of @shuntingTime. |
Related Development Tickets: | #343 |
Related Commits: | [1039] (Note on legacy SVN commits) |
Updated attribute(s): | @shuntingTime |
Updated element(s): | <ocpTT> |
New attribute @parentRef added
Fact: | The attribute @parentRef was added in order to allow for hierarchies of categories. |
Reason: | Requirement from the community. |
Related Development Tickets: | #437 |
Related Commits: | [1039] (Note on legacy SVN commits) |
New attribute(s): | @parentRef |
Updated element(s): | <category> |
New attribute @organizationalUnitRef added
Fact: | The attribute @organizationalUnitRef was added in order to differentiate between categories of the same name that are related to different organizationalUnits and thus may differ in semantics. |
Reason: | Requirement from the community. |
Related Development Tickets: | #436 |
Related Commits: | [1039] (Note on legacy SVN commits) |
New attribute(s): | @organizationalUnitRef |
Updated element(s): | <category> |
Interlocking Subschema
Infrastructure Subschema
New @trainProtectionSystem for <trainProtectionChange> and <trainProtection>
Fact: | new attribute @trainProtectionSystem (string) has been added in elements <trainProtectionChange> and <trainProtection>.
@trainProtectionSystem shall reference values from codelist TrainProtectionSystems.xml. |
Reason: | <trainProtectionChange> and <trainProtection> were missing a parameter to reference the train protection system – compare the forum discussion (link to the railML® website). |
Related Development Tickets: | #356 |
Related Commits: | [1039] (Note on legacy SVN commits) |
New attribute(s): | @trainProtectionSystem |
Updated element(s): |
@dir deprecated for many elements
Fact: | For many Elements @dir gets deprecated according to the following guidelines:
|
Reason: | There are some elements, where the @dir attribute does not make much sense. Either, because the element is valid for both directions of travel or because the element shall be only defined for one direction. So, the task is to identify elements where the @dir attribute shall be marked DEPRECATED. |
Related Development Tickets: | #357 |
Related Commits: | [1039] (Note on legacy SVN commits) |
Updated attribute(s): | @dir |
Updated element(s): | <trackCircuitBorder>, <brigde>, <levelCrossing_levelCrossings>, <platformEdge>, <serviceSection>, <tunnel>, <axleWeightChange>, <clearanceGaugeChange>, <electrificationChange>, <gaugeChange>, <ownerChange>, <powerTransmissionChange>, <radiusChange> |
New Attribute <levelCrossing>@offset
Fact: | New optional attribute <levelCrossing>@offset |
Reason: | Attributes @pos and @absPos shall describe by default the location of the (geometric) middle of the level crossing. Half the @length is before @pos and the other half is after.
In order to define a different setting, the new optional attribute <levelCrossing>@offset can be used. It describes how many metres of the @length is before @pos. If @offset is not given, the default value shall apply. |
Related Development Tickets: | #374 |
Related Commits: | [1039] (Note on legacy SVN commits) |
New attribute(s): | @offset |
Updated element(s): | <levelCrossing> |
Updated definitions for the values of <track>@type
Fact: | The definitions of the values of <track>@type have been updated |
Reason: | Definitions of track types in railML 2 wiki differ from consensus in forum and best practices in wiki 🡪 to be consolidated. |
Related Development Tickets: | #376 |
Related Commits: | [1039] (Note on legacy SVN commits) |
Updated attribute(s): | @type |
Updated element(s): | <track> |
Value unknown of <track>@mainDir removed
Fact: | The value unknown of <track>@mainDir has been removed. |
Reason: | unknown has the same meaning as a missing @mainDir. |
Recommendation: | Despite the value unknown still exists in older schemas, consider it deprecated retroactively. |
Related Development Tickets: | #324 |
Related Commits: | [1039] (Note on legacy SVN commits) |
Updated attribute(s): | @mainDir |
Updated element(s): | <track> |
Rollingstock Subschema
<segmentTable> introduced
Fact: | Several instances of <segmentTable> have been introduced. |
Reason: | There was demand for an alternative to <valueTable> |
Related Development Tickets: | #385 |
Related Commits: | [1039] (Note on legacy SVN commits) |
New element(s): | Several instances of <segmentTable> |
Updated element(s): | The respective parents, comp. <segmentTable> |