The PDS Simulator is a tool that mimics the Patient Demographic Supplier on a test instance. This simulutor can participate as a responder in many tests, like the PDQ_Exact_Name test define in Gazelle. The PDS Simulator has a GUI that helps to configure and manage this simulator. Users can specify patients in the database of the PDS Simulator. They can manually add patients, or can requests the Demographic Data Server to generate patients and save them on the PDS database.
The GUI of the PDS Simulator provides an access to all queries/responses received/send by the simulator.
The PDS Simulator interacts with gazelle using the simulator web service API.
PDS Simulator's communication with gazelle
This figure represents steps needed using web service methods of PDS Simulator to launch a test with a system consumer:
Gazelle uses the web service method startTestInstance to start a new communication with the PDS Simulator. Then it uses the web service method setTestPartenerConfigurations to send the configuration of the system under test, which is a patient demographic consumer. So the communication between the simulator and the SUT is done, and the SUT can send HL7 query to the PDS simulator, and wait for a HL7 response.
The GUI of the PDS Simulator lets us to view configurations and systems in communication with the simulator. And we can also view all messages sent and received by the simulator.
Installation and documentation
You can download PDS Simulator from the forge of the INRIA. You have to download the project GS-Common too. The links to sources are https://scm.gforge.inria.fr/svn/gazelle/branches/simulators/PDQPDSSimulator and https://scm.gforge.inria.fr/svn/gazelle/branches/simulators/GSCommon-ejb. To install PDS Simulator, you should download openempi from here. You should have two jboss: jboss-4.0.5.GA and jboss-5.1.0.GA.
1- Installation of openempi
First you have to install openempi on jboss-4.0.5.GA. You create a database on postgreSQL named openempi. Then you have to launch the sql script named ICS_schema_create-postgres.sql, that you download with the openempi zip file. You copy then the ear of openempi to the deploy folder of jboss-4.0.5. The last thing that you need to do is copy the two OpenEMPI files ICS.properties and IcsSql.xml from the dist/conf directory to the root directory of the jboss-4.0.5. Then you launch this jboss using ports-01 as ServiceBindingManager on the configuration file jboss-service.xml.
2- Installation of PDQPDSSimulator
You have first to create a database on postgreSQL named pdq-pds-simulator. Then you add the ear of PDS Simulator to the deploy folder of jboss-5.1.0.GA.
The documentation of the PDS Simulator is available here.