How to get started
First of all, note that, like the other applications from Gazelle testing platform, Order Manager is linked to our CAS service. That means that, if you have an account created in Gazelle, you can use it, if you do not have one, you can create one now by filling the form here. The login link ("cas login") is located in the top right corner of the page.
The OrderManager application is dedicated to the test of several actors and transactions in different domains.
Being logged in the application will give you access to some additional features. As an example, each time you create a new object in the application (patient, order, worklist ...), if you are logged in, you will be set as its "creator", which will enables you to easily retrieve your items. If the system you are testing has to receive messages from the OrderManager, the system you have selected will be stored into your preferences and the application will offer you this one in first position, the next time you launch a test.
Most of the transactions offered by the Order Manager are based on HL7v2.x standard. If your system acts as an HL7 responder in one of the transactions offered by the simulator, for example your system is an Order Placer and supports RAD-3 transaction, you will have to enter its configuration in the application.
In order to proceed, go to "System Configurations" and hit the "Create a Configuration" button. You can also copy or Edit an existing configuration (one of yours !).
In both cases, the simulator needs to know:
- A name for your configuration (displayed in the drop-down list menus)
- The actor played by your system under test
- The receiving facility/application
- The IP address
- The port the system is listening on
- The charset expected by your SUT
If you are logged in when creating the configuration, you will be set as the owner of the configuration. If you do not want other testers to send messages to your SUT you can uncheck the box "Do you want this configuration to be public?" and you will be the only one to be able to select your system in the drop-down list and to edit it (if logged in !).
Before sending messages to your system under test, ensure that your firewall options give to OrderManager the access to your system.
Starting a test
The menu part located at the top of the application offers access to the three IHE domains in which the Order Manager can be involved for testing. Each domain menu is divided into sub menu, each of them standing for an actor of the domain. The other entries are dedicated to the application configuration and browsing.
- SUT configurations is the starting point for users who test an HL7 responder, this menu is a link to the page of system configurations
- HL7 messages leads to the page gathering all the HL7 messages sent and received by the simulator.
Below are some tips to easily access the right page of the tool depending on what you want to do.
Send and receive queries for AWOS
If you want to test your Analyzer Manager, select Laboratory//[LAB-27]Query Analyzer Manager for AWOS to send messages (defined by LAB-27 transaction) to your system under test
If you want to test your Analyzer, select Laboratory/Analyzer Manager/Configuration : this page shows the configuration of the Analyzer Manager actor to which your Analyzer can send messages in the context of a LAB-27 transaction.
Create, cancel, replace ... an order
If you want to test your Order Filler, select the Radiology/Order placer submenu. This sub menu will offer you 2 choices
- [RAD-2] Create/Cancel order: use this page to send the messages specified by the Placer Order Management transaction (RAD-2) to your Order Filler
- Configuration : this page shows the configuration of the Order Placer to which your Order Filler can send messages in the context of a RAD-3 transaction.
If you want to test your Order Placer, select the Radiology/Order filler submenu. This sub menu will offer you 2 choices
- [RAD-3] Create/Update/Cancel order: use this page to send the messages specified by the Filler Order Management transaction (RAD-3) to your Order Placer
- Configuration : this page shows the configuration of the Order Filler to which your Order Placer can send messages in the context of a RAD-3 transaction.
If you want to test your Laboratory Order Placer, select the Laboratory/Order Filler submenu. This sub menu will offer 3 sets of transactions, only two of them are of your interest:
- [LAB-1/LAB-2] Notify Order Placer of orders: use this page to send messages (from LAB-1 and LAB-2 transactions) to your system under test
- Configuration: this page shows the configuration of the Order Filler to which your Order Placer can send messages in the context of a LAB-1 transaction.
Create a worklist and query the SCP
The part of the simulator acting as an Order Filler is also able to create DICOM worklists, the latter can be queried by your modalities in the context of RAD-5 transaction for instance. A kind of proxy is running and listening to your C-FIND queries, the ones are forwarded to the DICOM Basic Worklist Management SCP (wlmscpfs) from the DICOM toolkit developed by OFFIS, DCMTK. Before being forwarded, the messages are stored in database and the received responses are also stored before being forwarded to your system. In this way you can look at the exchange messages and we plan to add a validation service. The log file produces by the SCP is split and stored in the database of the tool, in that way you can consult more details about the DICOM association performed with our tool.