Click here to enter the XCPD Responding Gateway Simulator

The web service responder of this simulator is http://gazelle.ihe.net/XCPDRESPSimulator-XCPDRESPSimulator/RespondingGatewayPortTypeImpl?wsdl.

Configuration of the simulator

You can configure the XCPD Responding Gateway Simulator if you connect as admin, then you can see a new menu, administration, that contains two others sub-menus, XCPD-RESP Configuration and Users Management. The menu Users Management lets you to configure users and roles. The menu Users Management lets you to configure parameters of the simulator. The homeCommunityID is very important to be specified, because the responding XCPD webservice  uses this value to filter messages which are not destinated to it. This page lets you also to configure the XUA behavior.

How to write tests involving XCPD Responding Gateway actor

When a test instance is created with the XCPD Responding Gateway Simulator as one of the test instance participants, Gazelle needs some additional information to be able to communicate with the tool. 

When you edit a test definition, for each step in which the XCPD Responding Gateway actor acts as the initiator of the transaction, you are expected to give the following information:

• Transaction must be ITI-55
• If the communications have to be secured, make sure you have checked the TLS option.

Communication with gazelle

This simulator can communicate with gazelle using webservices. This web service is http://jumbo-2.irisa.fr:8080/XCPDRESPSimulator-XCPDRESPSimulator/XCPDRESPSimulatorWS?wsdl. Each time a new testInstance began with this simulator, a webmethod from this simulator is called : startTestInstance, so the simulator can initiate a new TestInstance. The an other webMethod is called:  setTestPartnerConfigurations, the simulator can so know which system is communicating with it, and for what actor integration profile. At the end of the testInstance, an other webmethod is called : stopTestInstance. This allows the simulator to close the testInstance in its database, and set its status to completed.

Installation and Documentation

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

https://gforge.inria.fr/scm/viewvc.php/branches/simulators/XCPDRESPSimulator/?root=gazelle

https://gforge.inria.fr/scm/viewvc.php/branches/simulators/GSCommon-ejb/?root=gazelle

https://gforge.inria.fr/scm/viewvc.php/branches/simulators/GSCommon-ui/?root=gazelle

 

You can download these project using svn tool, as described here. The svn link to these projects are :

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

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

https://scm.gforge.inria.fr/svn/gazelle/branches/simulators/XCPDINITSimulator

Javadoc relative to the XCPDRESPSimulator will be soon available.

Click here to access the XCPD Responding Gateway Simulator

Introduction

The XCPD Responding Gateway simulator is developed in conformance with the IHE Technical Framework. It also implements the epSOS extension to the profile. It has been developed to simulate the Responding Gateway actor of the XCPD (Cross Community Access) integration profile in connectathon (or pre-connectathon) tests when needed. This tool can participate as a responder in many tests like XCPD_Patient_Discovery thanks to its web service methods which provide to Gazelle a mean to communicate with it. A Web GUI is also available and enables the users to see their message sended to this simulators. Also, we can via the GUI request directly the database of XCPD Responding simulator by XCPD request message. Note that this tool is able to respond to requests using TLS, using the port 8443.

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 validate the assertion.

Transactions and Messages supported

As a Responding Gateway for XCPD, this simulator supports the ITI-55 transaction.

 

HomeCommunityId of th XCPD Responding Simulator

To communicate with the web service of the simulator responding gateway, the HL7V3 request must contain the following homeCommunityId : 2.16.17.710.812.1000.990.1 

The homeCommunityId is the sending and receiving device and organization.

 

Users can access to the XCPD Responding simulator by its web services, or by its GUI.

1. Responding Gateway simulator webservices

The web service responder of this simulator is http://gazelle.ihe.net/XCPDRESPSimulator-XCPDRESPSimulator/RespondingGatewayPortTypeImpl?wsdl.

For the TLS use, the web service of the simulator is https://131.254.209.20:1443/xcpd?wsdl.

Here is an example of a soap-ui project that use the unsecured webservice.

2. User Interface

The user can access to the responding gateway simulator Here .

This interface contains a page to describe the list of messages received by the simulator. For each transaction via the webservice of the simulator, we save the request, the response, the date of creation and the ip address of the initiating gateway.

On this table, for each message received, we can view it, we can validate it, we can view also the response and validate its content.  We can also notice that for each couple of request/response, we have a permanent link, specified by a unique Id, the permanent link has this form : http://gazelle.ihe.net/XCPDRESPSimulator/transaction.seam?id=ID, exactly like it was done for XCPDINITSimulator.

 

On this permanent link, we specify the date of receiving the XCPD request, the IP of the sender and its country if we have this information, the type of the current trensaction, and the received message type. We can directly validate the received and the response messages from the current permanent link.

The GUI contains also a page on tools menu that lets to execute XCPD request directly within the use of the webservice, you have only to set the PRPAIN201305UV02 messages. The menu TestInstance which is common to all simulators contains list of TestInstance executed using gazelle with this simulator.