Application window Validator

From en.wiki.railvivid.railml.org
Jump to: navigation, search
Application window Validator
This page refers to version 1.04 of railVIVID®.
Therefore the content is possibly outdated.
The current version is 1.1.

Application window 'Validator...'


The validator view can be opened after the successful upload of a railML file by pressing the menu bar item 'Validator...' in the control window (see paragraph Menu item bar 'Validator...'). Subsequently an empty application window opens on the right hand side of the screen. railVIVID validates against the official railML-schema, that is implemented in the source code. No external references will be used. railML extensions will not be validated.

The following railML versions are supported:


•        railML 2.0 with the namespace        http://www.railml.org/schemas/2009
•        railML 2.1 with the namespace        http://www.railml.org/schemas/2011
•        railML 2.2 with the namespace        http://www.railml.org/schemas/2013
•        railML 2.3 with the namespace        http://www.railml.org/schemas/2016
•        railML 3.0 with the namespace        http://www.railml.org/schemas/2015


Note.png Tip: The railML release with the version number 3.0.0.8 is the youngest schema, supported by the application railVIVID


Rufzeichen.png Warning: A semantic review does not take place! It is possible that a valid railML file contains semantic nonsense. Follow-up semantic reviews may be implemented in future railVIVID versions.


After the start of the validation with the help of the control window the application window either shows a message, in case of a valid file, or a chart in case of a non valid file.


Valid review results of a railML file


Output after the validation for a valid railML file

The printout shows:

•        the complete file path of the railML file
•        the railML version, which is referred to and used for the validation.

This output shows a successful validation.


Non valid review results of a railML file


Output after the validation for a non valid railML file

The heading shows:

•        the complete file path of the railML file
•        the railML version, which is referred to and used for the validation.
•        the total number and displayed number of errors

In case of a non valid railML file a chart with the following columns will be displayed:


Content Content shows the message text of the current error and the local connection.
Line number
Line number shows the number of the line of the railML file in which the error occurred. This must not necessarily correspond with the incorrect position. In the case of numerous files (root file and integrated file) the reference refers to the file in the column "file".
Column number      
Column number shows the number of the column of the railML file in which the error occurred. This must not necessarily correspond with the incorrect position. In the case of numerous errors, firstly solely the amount of errors is displayed and not the exact column and line. The exact localisation of individual errors takes place in the grouped entries listed below.

A small triangle at the beginning of each line shows that the error occurred multiple times and was grouped. In order to see all error messages the grouping can be opened by clicking on the triangle. The previously grouped displayed error messages will then be presented indented.

The chart allows the following functionalities:


•        The rows can be sorted newly according to the entries in the selected column by clicking on the column head.
•        The sequence of the columns can be changed by moving the column heads (drag and drop).
•        The column width can be changed by moving the column margin in the column head.
•        The content can also be presented as Tooltip.


Birne.png Tip: If a column should not be visible, e.g. because of a very long content in a second column, the scroll bar at the bottom of the window can be used to reach the desired column.



Export of the validator output



With a right-hand click in the window background, e.g. output head, it is possible to export the validator result to other programmes. The following functions are offered for this:


• copy to Clipboard
• save as Excel...
• save as CSV...
• save as PDF...


Furthermore the user has the possiblity to launch the listed export functions via the semitransparent button at the top right picture border (see illustration).

800px|thumb|center|Context menu in validator view