Template:Change: Difference between revisions
Jump to navigation
Jump to search
[checked revision] | [checked revision] |
(Parameter optional gemacht) |
(→Example: Expansion) |
||
Line 79: | Line 79: | ||
delivers: | delivers: | ||
{{ | |||
{| | |||
| | {{#if:{{Attr|@abbrevation}} and {{attr|@number}} in the {{IS:Tag|ocp}} element have been declared deprecated. {{attr|@parentOcpRef}} and {{IS:Tag|designator}} have been introduced. {{IS:Doc|additionalName|ocp}} has been expanded by [[IS:additionalName_ocp#type|{{attr|@type}}]].| | ||
| | {{!}}style="vertical-align:top"{{!}}Fact: | ||
| | {{!}}style="vertical-align:top"{{!}}{{Attr|@abbrevation}} and {{attr|@number}} in the {{IS:Tag|ocp}} element have been declared deprecated. {{attr|@parentOcpRef}} and {{IS:Tag|designator}} have been introduced. {{IS:Doc|additionalName|ocp}} has been expanded by [[IS:additionalName_ocp#type|{{attr|@type}}]]. | ||
|svn={{svn|335}}, {{svn|439}} | {{!}}- | ||
| | }} | ||
{{#if:There are multiple different abbreviations and numbers for single operation or control points. They can't be defined with one attribute. Use, depending on context, {{IS:Tag|designator}} or {{IS:Doc|additionalName|ocp}} instead. {{attr|@parentOcpRef}} allows for grouping ocps. {{IS:Tag|designator}} allows for more codes than the depricated {{attr|@code}}, plus it can establish a relation with the [[CO:codelists|codelist]] ''Registers.xml''. {{IS:Doc|additionalName|ocp}}/{{attr|@type}} allowes to declare the context of a name: is it valid under operational or traffic aspects, or as a local name?| | |||
{{!}}style="vertical-align:top"{{!}}Reason: | |||
{{!}}style="vertical-align:top"{{!}}There are multiple different abbreviations and numbers for single operation or control points. They can't be defined with one attribute. Use, depending on context, {{IS:Tag|designator}} or {{IS:Doc|additionalName|ocp}} instead. {{attr|@parentOcpRef}} allows for grouping ocps. {{IS:Tag|designator}} allows for more codes than the depricated {{attr|@code}}, plus it can establish a relation with the [[CO:codelists|codelist]] ''Registers.xml''. {{IS:Doc|additionalName|ocp}}/{{attr|@type}} allowes to declare the context of a name: is it valid under operational or traffic aspects, or as a local name? | |||
{{!}}- | |||
}} | |||
{{#if:Use the new {{IS:Tag|tsi}} and/or {{IS:Tag|designator}} elements instead.| | |||
{{!}}style="vertical-align:top"{{!}}Recomendation: | |||
{{!}}style="vertical-align:top"{{!}}Use the new {{IS:Tag|tsi}} and/or {{IS:Tag|designator}} elements instead. | |||
{{!}}- | |||
}} | |||
{{#if:{{ticket|112}}, {{ticket|153}}| | |||
{{!}}style="vertical-align:top"{{!}}Related Trac Tickets: | |||
{{!}}style="vertical-align:top"{{!}}{{ticket|112}}, {{ticket|153}} | |||
{{!}}- | |||
}} | |||
{{#if:{{svn|335}}, {{svn|439}}| | |||
{{!}}style="vertical-align:top"{{!}}Related SVN Commits: | |||
{{!}}style="vertical-align:top"{{!}}{{svn|335}}, {{svn|439}} | |||
{{!}}- | |||
}} | |||
{{#if:Old sample (railML 2.1): | |||
<syntaxhighlight lang="xml"> | |||
<ocp ... name="Passau Hbf." abbrevation="NPA"/> | |||
</syntaxhighlight> | |||
New sample (railML 2.2): | |||
<syntaxhighlight lang="xml"> | |||
<ocp ... name='Passau Hbf.' ...> | |||
<tsi country="80"/> | |||
<designator register='RL100' entry='NPA'/> | |||
<designator register='ENEE' entry='80-26506-6'/> | |||
<designator register='PLC' entry='DE18274'/> | |||
<designator register='IBNR' entry='8000298'/> | |||
<designator register='DB640' entry='Pa'/> | |||
</ocp> | |||
</syntaxhighlight>| | |||
{{!}}style="vertical-align:top"{{!}}Example: | |||
{{!}}style="vertical-align:top"{{!}}Old sample (railML 2.1): | |||
<syntaxhighlight lang="xml"> | <syntaxhighlight lang="xml"> | ||
<ocp ... name="Passau Hbf." abbrevation="NPA"/> | <ocp ... name="Passau Hbf." abbrevation="NPA"/> | ||
Line 101: | Line 138: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
}} | }} | ||
|} | |||
[[Category:ContentTemplate]] | [[Category:ContentTemplate]] | ||
</noinclude> | </noinclude> |
Revision as of 15:35, 12 June 2017
Usage
This template is suposed to standardize the depiction of changes between railML® versions. It is used in certain subpages of Changes.
Arguments
The template has five optional arguments:
- fact: a prompt of the change, e.g. Element X has been extended by attribute Y.
- reason: an explanation of why and how the change has been implemented.
- recomendation: any recomendations
- trac: a list of related trac tickets. Pleas, employ Template:Ticket.
- svn: a list of related svn commits. Please, employ Template:SVN.
- example: An example, usually a code snippet.
Empty Template
{{change |fact= |reason= |recomendation= |trac= |svn= |example= }}
Example
{{change |fact={{Attr|@abbrevation}} and {{attr|@number}} in the {{IS:Tag|ocp}} element have been declared deprecated. {{attr|@parentOcpRef}} and {{IS:Tag|designator}} have been introduced. {{IS:Doc|additionalName|ocp}} has been expanded by [[IS:additionalName_ocp#type|{{attr|@type}}]]. |reason=There are multiple different abbreviations and numbers for single operation or control points. They can't be defined with one attribute. Use, depending on context, {{IS:Tag|designator}} or {{IS:Doc|additionalName|ocp}} instead. {{attr|@parentOcpRef}} allows for grouping ocps. {{IS:Tag|designator}} allows for more codes than the depricated {{attr|@code}}, plus it can establish a relation with the [[CO:codelists|codelist]] ''Registers.xml''. {{IS:Doc|additionalName|ocp}}/{{attr|@type}} allowes to declare the context of a name: is it valid under operational or traffic aspects, or as a local name? |recomendation=Use the new {{IS:Tag|tsi}} and/or {{IS:Tag|designator}} elements instead. |trac={{ticket|112}}, {{ticket|153}} |svn={{svn|335}}, {{svn|439}} |example=Old sample (railML 2.1): <syntaxhighlight lang="xml"> <ocp ... name="Passau Hbf." abbrevation="NPA"/> </syntaxhighlight> New sample (railML 2.2): <syntaxhighlight lang="xml"> <ocp ... name='Passau Hbf.' ...> <tsi country="80"/> <designator register='RL100' entry='NPA'/> <designator register='ENEE' entry='80-26506-6'/> <designator register='PLC' entry='DE18274'/> <designator register='IBNR' entry='8000298'/> <designator register='DB640' entry='Pa'/> </ocp> </syntaxhighlight> }}
delivers:
Fact: | @abbrevation and @number in the <ocp> element have been declared deprecated. @parentOcpRef and <designator> have been introduced. additionalName has been expanded by @type. |
Reason: | There are multiple different abbreviations and numbers for single operation or control points. They can't be defined with one attribute. Use, depending on context, <designator> or additionalName instead. @parentOcpRef allows for grouping ocps. <designator> allows for more codes than the depricated @code, plus it can establish a relation with the codelist Registers.xml. additionalName/@type allowes to declare the context of a name: is it valid under operational or traffic aspects, or as a local name? |
Recomendation: | Use the new <tsi> and/or <designator> elements instead. |
Related Trac Tickets: | #112, #153 |
Related SVN Commits: | [335] (Note on legacy SVN commits), [439] (Note on legacy SVN commits) |
Example: | Old sample (railML 2.1):
<ocp ... name="Passau Hbf." abbrevation="NPA"/> New sample (railML 2.2): <ocp ... name='Passau Hbf.' ...> <tsi country="80"/> <designator register='RL100' entry='NPA'/> <designator register='ENEE' entry='80-26506-6'/> <designator register='PLC' entry='DE18274'/> <designator register='IBNR' entry='8000298'/> <designator register='DB640' entry='Pa'/> </ocp> |