Introduction

EVS is an evolution of EVSc, using gateway-integration instead of Vitalink connector-integration. It allows the manipulation of vault contents using specific actors and specific patients, manually or based on previously exported vault contents.

After initial installation, some examples are available to get familiar with the functionalities of EVS, without the need for further configuration.

This manual describes EVSg EVS v2.1.0.

Functionality

General

EVSg EVS allows a certain actor to perform, for a certain patient, a number of actions.

These actions are triggered by dropping input files in (subfolders of) the input-folder:

EVSg EVS watches these folder(s), executes the action(s) and generates output in the processed-folder:

EVSg EVS can be launched via the "vault-uploader.cmd" batch file:

The behaviour of EVSg must EVS must be determined by passing some mandatory parameters. Instead of using the "vault-uploader.cmd" batch file, it is easier to use the example batch file "start EVS.cmd":

...

This batch file contains parameter values for a standard behaviour. How the parameters change the behaviour can be found in the paragraph EVSg user manualParameterisation.

Input-folder

Which patient?

The patient is determined by the folder under "..\exe\interaction\input".

After initial installation, 1 patient named "katrien" is available:

Which actor?

The actor is determined by the folder under "..\exe\interaction\input\<patient folder>".

After initial installation, 1 actor named "gp_van_gucht" is available:

Which files?

Any type of files, with any extension, can be dropped. They are considered as "input-files". EVSg willEVS will, depending on the action folder, parse the files and extract the Kmehrmessage(s).

...

MSE and TS transactions.

What is a Kmehrmessage?

A Kmehrmessage is a part of the file that starts with <kmehrmessage ...> and ends with </kmehrmessage>. One file can contain 0 or more Kmehrmessages.  One Kmehrmessage can contain 0 or more MSE and TS transactions.

EVS EVSg will work with Kmehrmessages of Kmehr-standard 20120401 and Kmehr-standard 20161201 . It will automatically convert Kmehrmessages of Kmehr-standard 20120401 to Kmehr-standard 20160401.as input.

All data (among which the metadata) extra data needed for the communication with the gateway will be generated by the EVSg and/or the Vitalink platform. EVS. As input the data as depicted in the image below will be used:

How is a

...

"medication" identified?

For some actions, typically removing and updating data entries"medications", the medication that medication that should be changed needs to have an identification. Those medications are expressed as MSE transactions. These MSE transactions are identified by using an EVS reference.

Identification by EVS reference

An EVS reference is put in 1 (and only 1) free text field in the concerned medicationMSE transaction.

The EVS reference can be freely chosen, and facilitates the definition and execution of scenarios.

In the next example, this REF is "===EVSREF:901===". EVSg EVS detects the reserved format  "===EVSREF:<any text>===" and finally uses "<any text>" as unique REF.

...

If multiple EVS REFs have been given for 1 medicationMSE transaction, EVSg EVS will not execute an the action and will raise an error.

Image Modified

Which actions?

Depending on the folder where the input-file is dropped, EVSg EVS will execute an action.

Action "add"

This action will add a data entry transaction to the vault for all transactions found in each Kmehrmessage found in all dropped files. If one of the medications MSE transactions within a kmehrmessage does not have an EVS REF yet, this an EVS REF will be generated.

In the example below, 3 Kmehrmessages transactions are dropped to be added to the vault:

Image RemovedImage Added

Action "export"

This action will export the contents of the vault, without any change to the vault itself. EVSg  EVS will do this action once for each dropped file, without parsing this file.

In the example below, a newly created file will trigger an export of the contents of the vault:

Action "generateREF"

This action will generate an EVS REF for each medication within a kmehrmessage.

If an EVS REF exists already in the medication, no new EVS REF will be generated.

MSE transaction currently in the vault.

If an EVS REF exists already in the MSE transaction, no new EVS REF will be generated.

If no EVS REF exists, the If no EVS REF exists, the new EVS REF is put in the instructionforpatient field.

Image RemovedImage Added

Action "replace"

This action will replace the contents of the vault by all the Kmehrmessages transactions found in the input file. Be aware of the fact that dropping multiple files in the replace-folder will result in a vault with as contents the Kmehrmessages transactions of the last input file! If one of the medications MSE transactions within a kmehrmessage file does not have an EVS REF yet, this will be generated.

In the next example, after processing the next 3 input files, the vault contains 2 data entriestransactions.

Image RemovedImage Added

Action "updateschemeREF"

This action will update the complete contents of the vault, based on the input file compared with the current contents of the vault.

Image RemovedImage Added

The next actions will take place:

• a medication an MSE transaction with EVS REF not yet existing in the vault will be added to the vault, together with all TS transactions which are linked with this MSE transaction
• an MSE transaction with a medication with EVS REF already existing in the vault will cause an update but only if medication differs from the vault-medicationif any difference between the input-transaction and vault-transaction is found
• all MSE transactions all medications without corresponding EVS REF in the input file will be removed from the vault

If the input-file contains medications MSE transactions with EVS REFs that are not unique, the action will not be executed and an error will be thrown.

Processed-folder

Processed-folder

After execution After execution of an action a variable number of output files are generated in the processed folder.

...

...

Logs-folder

Root

This folder contains:

• the eHealth technical connector logs for EVS: ehealth_uploader*.log
• the eHealth technical connector logs for EVS-exporter: ehealth_exporter*.log
• the proprietary EVS log for EVS: evs_uploader.log
• the proprietary EVS log for EVS-exporter: evs_exporter.log
• a folder 'communication'

Image Added

Communicaton-folder

This folder contains all the requests and responses done by EVS when communicating with the gateway.

Image Added

Configuration

This paragraph explains how to configure EVSgEVS.

How to add a patient?

Extra patients can be added by creating files in the next folder:

...

Since EVS follows all the rules for eHealth and Vitalink, it is up to the user to make sure the proper eHealth dependencies (informed consent, therapeutic relation, ...) are set in function of the wanted behaviour.

How to add an actor?

Extra actors can be added by creating files in the next folder:

Image Removed

files in the next folder:

Image Added

After initial installation, some actor config files are already present. All can be used as example (copy-paste) to add extra actors. The name of the file, without the extension, needs to be used to identify by which actor the action needs to be performed.

...

After copy paste of the appropriate example file, insert the correct info for the new actor:

Image Modified

The needed info in the above template is the certificate name, the password of the certificate, the SSIN, the NIHII number and the actor's name. The location of the certificate can be freely chosen, but it is good practice to put it in the same folder as the example by installation:

...

Since EVS follows all the rules for eHealth and Vitalink, it is up to the user to make sure the proper eHealth dependencies (therapeutic relation, ...) are set in function of the wanted behaviour.

Parameterisation

The next parameters can be passed when launching EVSgEVS:

Example of a parameterisation:

Appendix A: Folder structure

...

EVS 2.

...

x.

...

y

This paragraph gives a brief overview of the folder structure after initial installation. It can be used as reference while using and configuring the EVS.

Path							Reserved path	Reserved name	Explanation
EVSgEVS									The root folder. The name and location can be freely chosen. Keep in mind that paths used in scenarios, patient and actor files are possibly impacted by changes to this!
	\config								Everything that defines the behaviour of EVSgEVS, configured as needed by the user.
		\actors							All the actors that can be used by EVSgEVS.
		\log4j							Settings of the log4j library. Please refer to https://logging.apache.org/log4j/2.x/manual/configuration.html for more explanation.
		\patients							All the patients that can be used by EVSgEVS.
	\exe
		\certificates							The certificates used in the actor configuration files.
		\exports							The folder were the EVS-exporter will put exported vault contents, see EVSg user manual AppendixB:EVSexporter
		\interaction
			\input
				\katrien
					\gp_van_gucht
						\add
						\export
						\generateREF
						\replace
						\updateschemeREF
				\patient_template
			\processed
	\logs								Can be configured through the log4j settings.
		\communication
	\scenarios
		\basic_example
	\system
		\dependency-jars

Appendix B: EVS-exporter

Besides the interaction provided by dropping files in the input folder, EVSg EVS offers as extended functionality the continuous monitoring of the vault contents. This functionality is provided by EVS-exporter.

Launching

EVS-exporter can be launched via the "vault-exporter.cmd" batch file:

...

After initial installation, launching the EVS-exporter means that the vault contents of the patient "katrien" will be monitored.

Output

When EVS-exporter detects for the given patients a change in the vault contents, an export is executed. The export is also executed after intial initial launch.

The exported files are put in the next folder, with for each monitored patient a subfolder. The subfolder is automatically created when the monitoring for this patient is initially started.

...

The files contain the same as the files generated by EVSg EVS in the processed-folder, but the filenames differ.

...

When the export fails, an error file will be generated, which is the same behaviour as for the folder-triggered export action of EVSgEVS.

Parameterisation

The next parameters can be passed when launching EVS-exporter:

...