Login

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, the first thing you have to ensure when you enter in to the application, is that the selected domain is the one for which you want to test. The drop-down menu enabling you to select the domain is situated in the bottom right corner. Once you have selected it, it remains the same during the whole session except if you change it. If you are logged in, note that the last selected domain is kept in the database in order to pre-select it the next time you visit the application. See below an illustration of this menu.

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.

Be aware that some parts of the application are only reachable by logged in users. It is more particularly the case for the configuration of the parts of the simulator acting as HL7 responders. That means that, if you want to send messages to the OrderManager, for example in the context of the test of your Order Filler for RAD-3 transaction, you will need to be logged in to retrieve the configuration (IP address, port, sending application/facility) of our Order Placer. In the page which summarizes the configuration of the Order Placer, you will also find the list of messages received by this part of the simulator and the link to validate the messages you have sent.

Registration of Systems Under Test acting as HL7 responders

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 application has been split into different parts, each part corresponding to a transaction or a set of related transactions. Below is the list of all menu items you may encounter in the application. Each item will be explain later in this page.

• Order management
• Appointment management
• Worklist management
• Result management

The following items are dedicated to the application configuration or data browsing

• Browse data 
  • For Radiology and Cardiology, contains four sub-menus enabling the user to find out a patient, an order, an appointment, a worklis using various search criteria. 
  • For Laboratory, contains a first sub-menu to find out a patient, then, a sub-menu by actor. For each actor, you can retrieve the list of objects owned by this part of the simulator.
• 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.

Depending the domain you have selected, the menu bar will change. Actually, if you are testing Laboratory domain, you do not need to access the DICOM worklist part of the simulator but you might want to access the "Test Result Management" part.

Send and receive queries for AWOS

If you want to test your Analyzer Manager, select Analyzer/Query Analyzer Manager for AWOS to send messages (from LAB-27 transaction) to your system under test

If you want to test your  Analyzer, select Analyzer Manager/Analyzer Manager Configuration (displayed if logged in): this page shows the configuration of the Analyzer to which your Analyzer can send messages in the context of a LAB-27 transaction. This page also gathers the messages received by our Analyzer Manager in the context of this transaction.

Create, cancel, replace ... an order

If you are developing an order placer or an order filler, no matter its domain of application, you may want to test the behaviour of your system when receiving a message for creating an order, cancelling it... Under the menu "Order management" you will find all the tools you need to do this.

If you want to test the RAD-2 transaction, select the Placer order submenu. This sub menu will offer you 2 choices

1. Send orders to your Order filler: if your system is an order filler, use this page to send to it the messages specified by the Order Placer Management transaction (RAD-2)
2. Order Filler configuration (displayed if logged in): this page shows the configuration of the Order Filler to which your Order Placer can send messages in the context of a RAD-2 transaction. This page also gathers the messages received by our Order Filler in the context of this transaction.

If you want to test the RAD-3 transaction, select the Filler order submenu. This sub menu will offer you 2 choices

1. Send orders to your Order placer: if your system is an order placer, use this page to send to it the messages specified by the Order Filler Management transaction (RAD-3)
2. Order Placer configuration (displayed if logged in): this page shows the configuration of our Order Placer to which your Order Filler can send messages in the context of a RAD-3 transaction This page also gathers the messages received by our Order Placer in the context of this transaction.

If you want to test your Laboratory Order Placer, select the Order Filler submenu. This sub menu will offer 3 choices, only two of them are of your interest:

1. Notify Order Placer of orders: use this page to send messages (from LAB-1 and LAB-2 transactions) to your system under test
2. Order Filler Configuration (displayed if logged in):  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. This page also gathers the messages received by our Order Filler in the context of this transaction.

If you want to test your Laboratory Order Filler, 

1. Select the Order Placer submenu. This menu will offer 2 choices:
   • Notify Order Filler of orders: use this page to send messages (from LAB-1) to your system under test
   • Order Placer Configuration (displayed if logged in):  this page shows the configuration of the Order Placer to which your Order Filler can send messages in the context of a LAB-1 and LAB-2 transactions. This page also gathers the messages received by our Order Placer in the context of these transactions.
2. Select the Automation Manager/Automation Manager Configuration (displayed if logged in): this page shows the configuration of the Automation Manager to which your Order Filler can send messages in the context of a LAB-4 transaction. This page also gathers the messages received by our Automation Manager in the context of this transaction.

If you want to test your Laboratory Automation Manager, select Order Filler/Notify Automation Manager of work orders to send messages (from LAB-4 transaction) to your system under test

If you want to test your Analyzer, select Analyzer Manager/Analytical Work Order Step Broadcast to send messages (from LAB-28 transaction) to your system under test

If you want to test your 
Analyzer Manager, select Analyzer/Analyzer Configuration (displayed if logged in): this page shows the configuration of the Analyzer to which your Analyzer Manager can send messages in the context of a LAB-28 transaction. This page also gathers the messages received by our Analyzer in the context of this transaction.

Send and receive appointment notifications

Appointment notification (RAD-48) transaction is an optional transaction used in Scheduled Workflow and Eye care workflow integration profiles. We have planned to implement both sides of this transaction (Order Filler and Order Placer actor). Under the appointment management menu, you will find two sub menus: 

1. Send notifications to your Order Placer: this page will enable you to configure the notification to send to your system acting as Order Placer for the RAD-48 transaction.
2. Order Placer configuration: this page contains the configuration of our Order Placer to which your Order Filler can send messages in the context of the RAD-48 transaction. This page also gathers the messaged received by our Order Placer in the context to this 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 listen 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 Worklist management menu offers you 4 sub menus:

1. Create a DICOM worklist: this page enables the user to create a DICOM worklist for a selected order holded by the Order Filler part of the simulator. 
2. View all DICOM worklist entries: this page gathers the worklist entries created within the simulator, that means all the DICOM worklists available in the SCP.
3. Worklist query messages: this page gathers the whole list of messages exchanged between the SCP and the system under test (modalities, importers ...)
4. Worklist query logs: this page gathers the logs produced by wlmscpfs tool

Manage order and test results

If you are developing an order filler, an order result tracker or an Automation Manager for the LTW integration profile (Laboratory), you may want to test the behaviour of your system when receiving a message containing laboratory results. Under the menu "Results management" you will find all the tools you need to do this.

If you want to test your Laboratory Order Result Tracker, select the Order Filler/Send test results to your ORT sub-menu.

If you want to test your Laboratory Automation Manager, in the context of the LAB-5 transaction, you have the possibility to send messages to our Order Filler. Select the Order Filler/Order Filler configuration (displayed if logged in) sub-menu in order to retrieve the configuration of the Order Filler part of the tool.

If you want to test your Laboratory Order Filler, 

1. Select the Automation Manager menu: this page enable you to configure the notification to send to your system acting as Order Filler for the LAB-5 transaction.
2. Select the Order Result Tracker menu (available if logged in): this page contains the configuration of our Order Result Tracker to which your Order Filler can send messages in the context of the LAB-3 transaction. This page also gathers the messaged received by our Order Filler in the context to this transaction.

If you want to test your Analyzer Manager, select the Analyzer menu: this page enable you to configure the notification to send to your system acting as Analyzer Manager for the LAB-29 transaction.

If you want to test your Analyzer, select the Analyzer Manager Configuration menu (available if logged in): this page contains the configuration of our Analyzer Manager to which your Analyzer can send messages in the context of the LAB-29 transaction. This page also gathers the messaged received by our Analyze Manager in the context to this transaction.