Conformance XCAI Initiating Imaging Gateway
This page describes IHE conformance tests for the Initiating Imaging Gateway actor in the XCA-I Integration Profile.
There are several classes of tests, and these are described below.
These are tests where the Initiating Imaging Gateway is retrieving images from a single Responding Imaging Gateway.
In these tests with a single Responding Imaging Gateway, the retrieve parameters are varied to make sure that the Initiating Imaging Gateway processes those parameters correctly. Some tests are success cases. Other tests exercise error cases.
There are tests where the Initiating Imaging Gateway needs to distribute a single request to multiple Responding Imaging Gateways, consolidate the results, and return those results to the requesting simulator. These tests include both success and error cases.
Your Initiating Imaging Gateway will be sent requests for three separate communities, A, B, and C. You are asked to configure information for A and B but not C. Requests for community C will test error conditions. The table below shows identifiers for actors in these communities.
| Community | Entity | Identifier Type | Identifier Value |
|---|---|---|---|
| A | Community | homeCommunityID | urn:oid:1.3.6.1.4.1.21367.13.70.101 |
| A | Imaging Doc Source | Repository Unique ID | 1.3.6.1.4.1.21367.13.71.101 |
| A | Imaging Doc Source | Repository Unique ID | 1.3.6.1.4.1.21367.13.71.101.1 |
| B | Community | homeCommunityID | urn:oid:1.3.6.1.4.1.21367.13.70.102 |
| B | Imaging Doc Source | Repository Unique ID | 1.3.6.1.4.1.21367.13.71.102 |
| C | Community | homeCommunityID | Do not configure. Testing an error condition. |
| C | Imaging Doc Source | Repository Unique ID | Do not configure. Testing an error condition. |
The endpoints of the simulator actors are tied to the session name you defined. When you create the test environment in the Conformance Test pane, it will tell you the URLs of the simulated actors.
Notes on Simulator Endpoints
- March, 2021: All traffic to the simulators is routed through a proxy. The URL of all simulator endpoints should begin with http://tools.iheusa.org/xds-imaging.
- March, 2021: No TLS configuration is available.
-
Access the XDSToolkit server that is designated for testing imaging actors.
-
For Connectathons, use http://tools.iheusa.org/xds-imaging
-
For other testing, contact the testing manager for the proper URL
-
-
Define a test session for your system. Follow the naming convention: organization-iig where organization is a short name. Do not use any spaces in the test session.
-
Define your Initiating Imaging Gateway as a system in the test software. Use following naming convention: organization-sut__iig.
-
Select the Conformance Tests link in the toolkit.
-
In the selection widget at the top right part of the Conformance Test pane, make sure you select the proper test session and your system as the system under test.
-
Select the Initiating Imaging Gateway tab in the Conformance Test pane.
-
If not already done, activate the button to create the simulator environment for your system. Simulator names and URLs are tied to your session name (hence, the naming convention above).
-
Configure your Initiating Imaging Gateway to use the simulators that are defined.
-
Configure your system to use the homeCommunityId that is listed in the Initiating Imaging Gateway tab of the Conformance Test pane. You cannot define your own value.
You are now ready to run the test cases.
We recommend that you run the Single Image, Single Gateway test as the first step. That will ensure that you are using the proper endpoint and that the test system is operating properly.
Once you have successfully completed the Single Image, Single Gateway test, you can run the remaining tests individually or you can run all of the tests as a batch.
Each time you run a test, the test software does remove the prior result and sends a new request to your Initiating Imaging Gateway. Running test A should not disturb the results from test B.
The Initiating Imaging Gateway tools use the standard results page introduced in the XDSTools4 version of software. The screen capture below shows an example of a set of tests where all tests are completed successfully. All individual tests need to succeed.
The arrows in the screen capture highlight the button to run all tests as well as the Test Context frame.
