XDR Document Source Simulator (Now integrated in XD* Client)

The XDR Document Source Simulator has been developed to act as the actor Document Source for the profile XDR in tests.

This tool can participate as an initiator in many tests like Multi Document Submission thanks to its web service methods which provides to Gazelle a mean to communicate with it. A Web GUI is also available and enables the users to test their XDR responding register. From this GUI, connecthaton participants can retrieve the messages sent and received, documents uploaded during a test instance they have initiated. Note that this tool is able to send requests using TLS.

This simulator also supports the XUA (Cross Enterprise User Authentication) profile and can act as a X-Service User actor. First developed for epSOS purposes, the epSOS instance of this simulator sends signed-body SOAP messages.

Installation of the XDR Document Source Simulator

You can download sources of the XDRSRCSimulator project from the INRIA Forge. This project required two additional modules: GSCommon-ejb and GSCommon-ui. Links to those sources are:

 

https://scm.gforge.inria.fr/svn/gazelle/trunk/simulators/GSCommon-ejb 

(svn co svn+ssh://scm.gforge.inria.fr/svn/gazelle/trunk/simulators/GSCommon-ejb)

https://scm.gforge.inria.fr/svn/gazelle/trunk/simulators/GSCommon-ui

(svn co svn+ssh://scm.gforge.inria.fr/svn/gazelle/trunk/simulators/GSCommon-ui)

https://scm.gforge.inria.fr/svn/gazelle/trunk/simulators/XDRSRCSimulator

(svn co svn+ssh://scm.gforge.inria.fr/svn/gazelle/trunk/simulators/XDRSRCSimulator)

Javadoc relative to the XDRSRCSimulator will be soon available. 

  • Installation of XDRSRCSimulator

 You have first to create a database on postgreSQL named xdr-src-simulator.

Command :   createdb -e xdr-src-simulator  -U gazelle -E UTF8 -W gazelle

Then you add the ear of XDRSRC Simulator to the deploy folder of jboss-5.1.0.GA.

Documentation

You access to the User manual here.

Transactions and Messages supported

As an Document Source for XDR, the simulator supports the ITI-41  transaction.

Provide and register Document Source (ITI-41)

The following message types can be sent Provide and Register document source.

When you select  the document type "eDispensation" or "eConsent", the simulator send two files the CDA file and the pdf (represents the copy of the CDA File).

When you select the document type "Pdf", the simulator send the Pdf file.

This simulator also supports the XUA (Cross Enterprise User Authentication) profile and can act as a X-Service User actor. You can't use the XUA if the XDS server recipient doesn't support XUA. 

 

Communication between the simulator and Gazelle

All simulators developed for interacting with Gazelle are built on the same model. The following diagram represents the different steps performed during a test instance.

 

Gazelle / Simulator interactions

Contextual Informations

 

This table lists the input and output contextual informations that Gazelle is expected to send to the simulator for each step, during a test instance. For each test instance, the simulator stores the contextual informations so that it can retrieve them for the next steps. 


Input Contextual Informations
label path description possible values
useXUA null indicates whether the simulator must turn 
XUA mode on or off
true or false
patientUniqueId $XDSDocumentEntryPatientId id of a patient known by the Responding 
Register
normalized patient unique id
typeDocument null Type document generate to sent eDispensation, eConsent, Pdf
Output Contextual Informations 
label path description possible values
soapResponse

soapResponse

XDR Recipient Soap Response