This application has been developed with the purpose of aggregating in a same user interface, the access to all validation services developed for IHE and its national extensions. Called services are the followings (non-exhaustive):
In the menu bar of the user interface, we have chosen to sort the validators by affinity domains; currently several affinity domains are available in the instance deployed at https://gazelle.ihe.net/EVSClient: IHE, IHE Germany, epSOS, CI-SIS France, e-sens, Sequoia and so on.
The External Validation Service Client application can be used for validating the following types of messages or documents:
Note that when using the EVS Client application, if you are NOT logged in, every document/message you validate is stored in our database, referenced and available to everybody. If you do not want to have your documents/messages public, then you need to log in using the “CAS login”, it uses your Gazelle’s (EU-CAT) credentials.
If the user is not logged on the application, his/her validation requests and results (that means the document/message submitted to the tool and the validation outcome) are available to everybody. We say that the result is “public”; it will be listed in the list of validation requests and everybody will be able to access and download both the validated file and the validation report.
If the user is logged on the application, by default, his/her validation requests and results will be set as “private”. That means that he/she will be the only one to see the validation requests in the list and to access it. A permanent link is created for each validation request, the ones leading to a private request have restricted permissions; only the owner of the validation requests (the one who performed the validation) will be able to access this page. If the preference value show_logs_from_colleagues is set to true then the user will share automatically all his/her validations log with the users beloging to the same organization.
A logged on user can choose to have a given validation request available to everybody. In this case, everybody will be able to list the request and to access both the validated file and the validation report. To do so, once the validation is performed (or at any moment from the result page), click on the “Make this result public” button. At any time, the owner of the request (and only him/her) will be able to change back the visibility of the result to private.
A logged on user can choose to keep his/her validation request (file + result) private but to allow certain users to access it also. In this case, clicking on the “share this result” button will generate a random key which, added to the URL will ensure that only the persons who know the permanent link (including the key) will be able to access the content of the validation request. The owner of the validation request will still be the only one to see the result in the list gathering all results but everyone knowing the link will be allowed to display the page. In case the preference value show_logs_from_colleagues is set to true, the log are still visibles by users belonging to the same organization.
Note that the admin and monitor users are able to access all the validation requests. It’s obvious that they were use them only for verification purposes and will not publish neither use them for other purposes.
By XML file we mean all messages or documents based on XML (CDA, HL7v3 messages, XD* metadata …) All those kinds of files can be validating using a schematron and/or a model-based validator. Once you have selected (in the top bar menu) the kind of XML object you want to validate, you will reach a page which ask you to upload the XML file to validate (be careful, the application allows only files with .xml extension) and to select the schematron and/or model-based validators to use.
Below is an example of the different steps for validating an XD-LAB report.
Select the menu CDA Validation in the IHE drop-down menu
Hit the “Add” button and select the XML file to validate in your system explorer
Select the schematron and/or the ObjectsChecker validator to use in one of the 2 drop-down list(s)
Finally, hit the “validate” button. After a while, the validation result will be displayed below the selection area.
The validation result page is divided into differents panels :
Select the menu HL7v2 menu in the IHE drop-down menu
Then, you must choose the HL7 message profile to use to validate your HL7 message. The “Guess profile” button, just below the box, can be used to guess automatically the HL7 message profile to use, it extracts fields MSH-9 and MSH-12 and filter on those values.
Finally, to launch the validation process, hit the arrow on the right side of the line corresponding to the message profile to use. This will launch the request for validation
For each of the validation services configured in the application, there is the possibility to access to the logs of validated files. The page to access the logs present the various logs of validation performed by the users of the application.
User with the admin role have now the ability to delete a specific log from this page.
The add-ons menu gives the user access to other tools that do not belong to any of the other menus. Those tools are not project specific. Among the add-ons
Schematrons section allows the user to download the schematrons which are used to validate XML files. Those schematrons are sorted according to the type of objects they validate.
The purpose of the DicomSCP screener is to query a DICOM SCP in order to identified the various SOP Class and Transfer Syntax that the SCP supports.
The message content analyzer is a tool that scans the content of message for known content.
If you don’t know the content of your file, or the validator you need to choose to validate your document you can use the Message Content Analyzer.
You can click on each part of the tree or in the table to display the content. You also can download each part.
You can click on the green arrow or validate part (I’m lucky validation can directly send you to the result validation of your part). After you click on the refresh button, the validation permanent link is added to the table and the validation result is displayed in the tree.
Message Content Analyzer offers the possibility to use the cross validation module embedded in EVSClient by uploading IHE_XDM.zip archives. When uploading this certain type of archive, a green arrow with a blue cross is displayed next to the IHE_XDM.zip part of the analysis. Clicking on this arrow will call an XDM cross validator, using files from the subset in the archive (Metadata and CDA Document). Those will be automatically uploaded as inputs of the cross validator.
Directly after the performance of the cross validation, you are redirected to the analysis in Message Content Analyzer. The previous green arrow is replaced by a colored bubble which is a link to the result of the cross validation (a simple click redirect to the result).
The version of the application can be queried using a rest request in the form of
The application responds with an xml content as follows
Access to the result of validation performed using the EVS Client application can be accessed using a REST request. The rest request is constructed as follow
where the oid argument is the oid of the validation instance of interest.
The application returns one of the following values
Release 2.1.0 of CDA Generator introduces a new service called CDA Scorecard. Based on the detailed report of validation of a CDA document, the tool computes statistics. This service can be used directly from EVS Client (5.1.0 and later) once the validation using a model-based validator has been performed. The feature is also available for validation logs generated by previous releases of CDA Generator. Once you get the validation report, a “Scorecard” tab is available. Move to this tab, and hit the “Get Scorecard” button. After a few seconds, you will see the scorecard.
The scorecard is divided into three parts:
Currently, only the scoring on constraints is available.
On the screenshot above, the summary sections reports three indicators:
In addition, we have types the constraints and the Type of constraints section shows you where are the gaps in your document.
The Detail section lists all the constraints and shows you how many time each contraint was executed and how many times it was successfully executed.
From version 5.5.0, the EVSClient tool can be configured to detect and validate the digital signatures (ds:Signature where ds stands for http://www.w3.org/2000/09/xmldsig#) present in XML documents. As an administrator, to allow this feature, you shall make sure that the preference ‘enable_dsig_validation’ is present and set to ‘true’. Setting this preference to false will cause the tool not to look for a ds:Signature element in the uploaded XML files.
The SQL script update-5.5.0.sql will help you creating those entries in the database.
If the feature is activated, when the user uploads an XML file (CDA document, HL7v3 message, SAML Assertion and so on), the tool will look for a ds:Signature element in the file. If such element exists, a notification is displayed to the user.
By checking the box, the user asks the tool to call the default XML Signature Validation service in parallel to the other validation(s) (model-based, schematron). When the validation ends, a new tab “Signature Validation” is displayed and shows the report of the XML Signature Validator.