Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: RSW connectivity and gateway scheme generation were added

...

NameOutput suffixExtensionDescriptionRemarks

Validation file

VALIDATION-OK

VALIDATION-<###>-FAILED

.valThe report of the validation.

The filename contains the number of warnings and errors when the validation fails.

 

Global scheme PDF

globalscheme.pdfA visualisation of the global scheme in PDF format.-

Daily scheme PDF

dailyscheme-<date>.pdfA visualisation of the daily scheme in PDF format.

This is the scheme of the medication that should be taken today.

Export file

-.expAn export of the contents belonging to transactiontype "Medicationscheme" of the vault.-

Input file

-.inpThe original input file.The filename does not include the number of transactions in the vault.

Gateway scheme PDF

(from 3.4.0 onwards)

gatewayscheme.pdf

A visualisation of the global scheme in PDF format, generated by the gateway.

Only generated in case EVS connects to the Vitalink Gateway.

-


Each filename of transactiontype "Sumehr" exists out of:

...

After copy paste of the example files, insert the correct info for the new patient:

Image RemovedImage Added

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.

...

Name

Values

Meaning
rootdir"..\exe\interaction"Relative or absolute path to the folder that needs to be watched by EVS. This folder should contain the requested actions.
writeAsIstrue|false

false: All patient data from the source Kmehrmessage will be replaced by the correspondign data of the used input patient. Since the Kmehr data model is used for this transformation, it is possible that other Kmehr structure elements are slightly changed too.

true: The Kmehrmessage will be sent to the vault untouched. Use this when really no manipulation on the source Kmehrmessage is desired.

exportAfterUploadtrue|false

true: Each action, excepted "export" itself, should be followed by an export.

false: No export is needed after execution of the triggered action.

validateExportAfterUploadtrue|false

true: Each action should be followed by validation of the vault content.

false: No validation is needed.

generateGlobalMedicationSchemetrue|false

true: Each action should be followed by the generation of a global scheme visualisation PDF.

false: No global scheme visualisation is needed.

generateDailyMedicationSchemetrue|false

true: Each action should be followed by the generation of a daily scheme visualisation PDF.

false: No daily scheme visualisation is needed.

dailyMedicationSchemeDate

generateGatewayMedicationScheme

(from 3.4.0 onwards)

true|false

true: Each action should be followed by the generation of a global scheme visualisation by the gateway.

false: No global scheme visualisation by the gateway is needed.

dailyMedicationSchemeDatedate("yyyy-MM-dd")

If no date has been given

date("yyyy-MM-dd")

If no date has been given, it will generate a daily medication scheme of the current date.

If a date has been given, it will generate a daily medication scheme of the given date.

startTransactionIdnumber

This number will be the number for the first transaction within the kmehrmessage of a putTransactionSetRequest in the context of a medicationscheme.

shiftAction

no_tag_and_no_shift

tag_and_no_shift

shift_and_tag

See Appendix C: Parameter shiftAction.

Example of a parameterisation:

Image Removed

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 EVS.

hub

(from 3.5.0 onwards)

VITALINK

RSW

The Hub to send requests to.

searchType

(from 3.5.0 onwards)

LOCAL

GLOBAL

LOCAL: instruct the hub to search only locally.

GLOBAL: instruct the hub to search also elsewhere. Only applicable after the hubs will have been linked which is not the case at the time of writing (23/08/2018)


Example of a parameterisation:

Image Added

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 EVS.

Path

Reserved

path

Reserved

name

Explanation
EVS     
 (fout)(fout)The root folder. The name and location can be freely chosen. Keep in mind that paths used in scenarios, patient and
Path

Reserved

path

Reserved

name

Explanation
EVS      (fout)(fout)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    
 (tik)(tik)

Everything that defines the behaviour of EVS, configured as needed by the user.

  \actors   
 (tik)(tik)All the actors that can be used by EVS.
  \log4j   
 (tik)(tik)Settings of the log4j library. Please refer to https://logging.apache.org/log4j/2.x/manual/configuration.html for more explanation.
  \patients   
 (tik)(tik)All the patients that can be used by EVS.
 \exe    
 (tik)(tik) 
  \certificates   
 (fout)(fout)The certificates used in the actor configuration files.
  \exports   
 (fout)

(fout)

The folder were the EVS-exporter will put exported vault contents, see AppendixB:EVSexporter
  \interaction   
 (fout)(fout) 
   \input  
 (tik)(tik) 
    \katrien 
 (tik)(fout) 
     \gp_van_gucht
 (tik)(fout) 






\m
(tik)(tik)This folder contains the actions for transactiontype "Medicationscheme"
      
\add(tik)(tik) 
      
\export(tik)(tik) 
      

\generateREF

(tik)(tik) 







\replace(tik)(tik)







\updateschemeREF(tik)(tik)






\s
(tik)(tik)This folder contains the actions for transactiontype "Sumehr"







\add(tik)(tik)







\empty(tik)(tik)







\export(tik)(tik)







\generateREF(tik)(tik)







\removeREF(tik)(tik)







\replace(tik)(tik)







\updateREF(tik)(tik)






\dadd(tik)(tik)This folder contains the actions for transactiontype "Diarynote"







export(tik)(tik)







generateREF(tik)(tik)







updateREF(tik)(tik)
    \patient_template 
 (tik)(tik) 
   \processed  
 (tik)(tik) 

\logs





(fout)(fout)Can be configured through the log4j settings.


\communication




(tik)(tik)
 

\scenarios

    
 (fout)(fout) 
  \basic_example   
 (fout)(fout) 
 \system    
 (tik)(tik) 
  \dependency-jars   
 (tik)(tik) 

...

Name

Values

Meaning
transactionType

"medicationscheme"

"sumehr"

"diarynote"

EVS-exporter supports 3 transactiontypes: medicationscheme, sumehr and diarynote.

Change this value accordingly.

patientsname(s) as defined in EVS configuration, comma separated

This(these) is(are) the patient(s) that will be monitored and whose vault content(s) will be exported.

actorname as defined in EVS configuration

This is the actor that will be used for exporting.

exportDirdefault "..\exe\exports"

This is the path where the output files will be generated. This location can be freely chosen.

validatetrue|false

true: Each export should be followed by validation of the vault content.

false: No validation is needed.

generateGlobalMedicationSchemetrue|false

true: Each action should be followed by the generation of a global scheme visualisation PDF.

false: No global scheme visualisation is needed.

generateDailyMedicationSchemetrue|false

true: Each action should be followed by the generation of a daily scheme visualisation PDF.

false: No daily scheme visualisation is needed.

(waarschuwing) This EVS functionality is still under development!

generateGatewayMedicationSchemetrue|false

true: Each action should be followed by the generation of a global scheme visualisation by the gateway

false: No global scheme visualisation by the gateway is needed.

dailyMedicationSchemeDatedate("yyyy-MM-dd")

If no date

dailyMedicationSchemeDatedate("yyyy-MM-dd")

If no date has been given, it will generate a daily medication scheme of the current date.

If a date has been given, it will generate a daily medication scheme of the given date.

hub

(from 3.5.0 onwards)

VITALINK

RSW

The Hub to send requests to.

searchType

(from 3.5.0 onwards)

LOCAL

GLOBAL

LOCAL: instruct the hub to search only locally.

GLOBAL: instruct the hub to search also elsewhere. Only applicable after the hubs will have been linked which is not the case at the time of writing (23/08/2018)

Example of a parameterisation:

...